Skip to main content
Celoxis API v2
LiveUpdated 2 Sep 2026

Entity

Projects

Retrieve and manage projects, including upsert and clone operations.

Endpoints

GET/api/v2/projectsRetrieve a list
GET/api/v2/projects/{id}Retrieve one record
POST/api/v2/projectsCreate records
PATCH/api/v2/projectsUpdate records
DELETE/api/v2/projects/{id}Delete a record

Upsert a project

POST/api/v2/projects/upsertCreate or update by external key
PUT/api/v2/projects/upsertCreate or update by external key

Provide a non-empty externalKey and do not send id. Celoxis updates the matching project or creates one. Multiple matches return HTTP 409.

bash
curl -X PUT \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "externalKey": "ERP-P-1001",
    "name": "Website Redesign",
    "workspace": 12345
  }' \
  'https://app.celoxis.com/psa/api/v2/projects/upsert'

Clone a project

POST/api/v2/projects/{id}/cloneCreate a project from an existing project

Send only the properties that should differ from the source project. The response contains the new project.

bash
curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "name": "Website Redesign Copy",
    "plannedStart": "2026-10-01"
  }' \
  'https://app.celoxis.com/psa/api/v2/projects/123/clone'