Entity

Tasks

Retrieve and manage tasks, predecessors, project moves, upserts, clones and notification behaviour.

Endpoints

GET/api/v2/tasksRetrieve a list

GET/api/v2/tasks/{id}Retrieve one record

POST/api/v2/tasksCreate records

PATCH/api/v2/tasksUpdate records

DELETE/api/v2/tasks/{id}Delete a record

Predecessors

GET/api/v2/tasks/{id}/predecessorsRetrieve all predecessors of a task

Move tasks

POST/api/v2/tasks/moveMove one or several tasks to another project

Send tasks as an array of task IDs and project as the destination project ID.

bash

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "tasks": [
      99259,
      99260,
      99261
    ],
    "project": 12345
  }' \
  'https://app.celoxis.com/psa/api/v2/tasks/move'

Disable notifications

PATCH/api/v2/tasks?notifications=falseUpdate tasks without email or in-app notifications

bash

curl -X PATCH \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "id": 99266,
    "actualPercentComplete": 64
  }' \
  'https://app.celoxis.com/psa/api/v2/tasks?notifications=false'

Upsert a task

POST/api/v2/tasks/upsertCreate or update by external key

PUT/api/v2/tasks/upsertCreate or update by external key

Provide externalKey, omit id, and identify the project by ID, name or external key as supported.

bash

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "externalKey": "ERP-T-9876",
    "name": "Design review",
    "project": "ERP-P-1001"
  }' \
  'https://app.celoxis.com/psa/api/v2/tasks/upsert'

Clone a task

POST/api/v2/tasks/{id}/cloneCreate a task from an existing task

Send only the properties that should differ from the source task. The response contains the newly created task.