Entity

Workflow App Records

Retrieve and manage records from configured Workflow Apps such as Risks, Issues and Approvals.

Endpoints

GET/api/v2/appsRetrieve a list

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

POST/api/v2/appsCreate records

PATCH/api/v2/appsUpdate records

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

Create a record

POST/api/v2/appsCreate a Workflow App record

Use app to identify the configured Workflow App. A record must belong to either a project or a workspace.

bash

Example

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "app": "Risk",
    "name": "Supplier delay",
    "description": "Delivery may slip",
    "project": "Website Redesign"
  }' \
  'https://app.celoxis.com/psa/api/v2/apps'

Upsert a record

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

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

Provide a non-empty externalKey (your system's id) and do not send id. The externalKey must be unique across all Workflow App records in the company. The response includes the usual record JSON plus action (created or updated) and success: true. Multiple matches return HTTP 409.

bash

Example

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: bearer YourTokenHere' \
  -d '{
    "externalKey": "ERP-A-1001",
    "app": "Bug",
    "name": "Investigate login issue",
    "project": "ERP-P-1001"
  }' \
  'https://app.celoxis.com/psa/api/v2/apps/upsert'