Create Project - Xenia Team API

There is no POST /projects endpoint. A project is created by calling Create Task with "isProject": true — the same endpoint that creates ordinary tasks, which branches on that flag. This page documents the project-specific half of that request; see Create Task for the full body contract.

Request

POST /api/v1/ops/workspaces/{workspaceId}/tasks

curl -X POST "https://api.xenia.team/api/v1/ops/workspaces/{workspaceId}/tasks" \
  -H "x-client-key: $XENIA_CLIENT_KEY" \
  -H "x-client-secret: $XENIA_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Monthly Safety Walk",
    "isProject": true,
    "projectType": "role",
    "assigneesRoles": {
      "creationType": "role",
      "roles": ["<role-id>"],
      "locations": [],
      "locationGroups": []
    }
  }'

curl -X POST "https://api.xenia.team/api/v1/ops/workspaces/{workspaceId}/tasks" \
  -H "x-client-key: $XENIA_CLIENT_KEY" \
  -H "x-client-secret: $XENIA_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Monthly Safety Walk",
    "isProject": true,
    "projectType": "user",
    "assignees": ["<user-id>", "<team-id>", "<location-id>"]
  }'

curl -X POST "https://api.xenia.team/api/v1/ops/workspaces/{workspaceId}/tasks" \
  -H "x-client-key: $XENIA_CLIENT_KEY" \
  -H "x-client-secret: $XENIA_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Compressor Inspection",
    "isProject": true,
    "projectType": "asset",
    "assets": ["<asset-id>"]
  }'

Project-specific fields

Field	Required	Description
`isProject`	yes	Must be `true`. Without it the call creates a single task, not a project
`projectType`	no (defaults to `user`)	One of `user`, `asset`, `role`. Any other value returns `400 Unsupported project type`
`assignees`	when `projectType` is `user`	Array of user, team or location ids, mixed freely
`assets`	when `projectType` is `asset`	Array of asset ids
`assigneesRoles.roles`	when `projectType` is `role`	Array of role ids

Every other field — schedule, recurrence, priority, checklist, location — is the same as Create Task.

Responses

Code	Meaning
`200`	Project row created. Its schedules are generated in the background
`400`	`Assignees are required for project`, `Assets are required for project`, `Role is required for project`, or `Unsupported project type`
`403`	The workspace does not have the Projects feature, or the key’s user lacks `Manage Tasks`

The call returns as soon as the project row exists, before its schedules are generated. Until that finishes the project’s state is not ready and the lifecycle routes (edit, pause, end) return 400 Project is under processing. Poll Get Project until state is ready.

Next steps

List Projects — find the project you just created
Project Management guide — the full lifecycle