curl --request POST \
--url https://api.xenia.team/api/v1/ops/workspaces/{workspaceId}/tasks \
--header 'Content-Type: application/json' \
--header 'x-client-key: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '
{
"title": "Weekly cooler audit",
"assignees": [
"8f1c0f2e-1111-4aaa-9bbb-0d1e2f3a4b5c",
"3ab9c8d7-2222-4bbb-8ccc-1e2f3a4b5c6d"
],
"dueTime": "2026-08-04T17:00:00-04:00"
}
'{
"data": [
{
"id": "232154c0-c239-48f8-b670-0e5d12fd64d0",
"title": "Reset the endcap planogram",
"taskStatus": "Open",
"priority": "High"
}
],
"message": "Task(s) Created"
}Create Task
Create a task in the workspace. Requires the Manage Tasks permission on the key’s user, an active subscription, and available capacity under the plan’s task limit. Set isProject: true to create a recurring project instead of a single task — see the Create Project page under Projects for the project-specific fields.
curl --request POST \
--url https://api.xenia.team/api/v1/ops/workspaces/{workspaceId}/tasks \
--header 'Content-Type: application/json' \
--header 'x-client-key: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '
{
"title": "Weekly cooler audit",
"assignees": [
"8f1c0f2e-1111-4aaa-9bbb-0d1e2f3a4b5c",
"3ab9c8d7-2222-4bbb-8ccc-1e2f3a4b5c6d"
],
"dueTime": "2026-08-04T17:00:00-04:00"
}
'{
"data": [
{
"id": "232154c0-c239-48f8-b670-0e5d12fd64d0",
"title": "Reset the endcap planogram",
"taskStatus": "Open",
"priority": "High"
}
],
"message": "Task(s) Created"
}Path Parameters
UUID of the workspace. Must be your key's own workspace.
"cb363f7e-c52a-4478-911d-f6a6f791090e"
Body
Task title. The only required field.
"Reset the endcap planogram"
"Swap in the new seasonal set"
"High"
User, team OR location IDs, interchangeably. Mutually exclusive with assigneesRoles.
Role-based targeting. Mutually exclusive with assignees.
Show child attributes
Show child attributes
Template to attach.
Task category / service type.
ISO-8601; always include the offset.
"2026-08-04T09:00:00-04:00"
ISO-8601; always include the offset.
"2026-08-04T17:00:00-04:00"
End of the schedule window for recurring work.
Earliest date the task may start. Note: startDate is derived, not accepted.
Starting status. Defaults to Open.
"Open"
Create one separate task per assignee.
Derive locationIds from each assignee.
Set to false to skip the notifications normally sent when a task is created: assignee email and push, in-app notifications, and watcher emails. Applies to every task generated by this request, including project schedules. Does not affect the acceptance email sent to a work request's submitter. Defaults to true.
Create a recurring project instead of a one-off task. Requires the Projects feature.
Required shape when isProject is true.
user, asset, role Required when projectType is asset.
Show the creator as the role of the API caller (the key's default user, or the x-client-user) instead of their name, e.g. "System Admin". Applies to task lists, task details and task emails. The underlying creator user is unchanged. Defaults to false.
true
Response
Task(s) created.