Skip to main content
POST
/
orchestration
/
runs
Create run
curl --request POST \
  --url https://api.getcargo.io/v1/orchestration/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workflowUuid": "<string>",
  "data": "<unknown>",
  "releaseUuid": "<string>"
}
'
{
  "run": {
    "uuid": "<string>",
    "workspaceUuid": "<string>",
    "workflowUuid": "<string>",
    "releaseUuid": "<string>",
    "nodes": [
      {
        "uuid": "<string>",
        "slug": "<string>",
        "config": {},
        "childrenUuids": [
          "<string>"
        ],
        "fallbackOnFailure": true,
        "position": {
          "x": 123,
          "y": 123
        },
        "kind": "native",
        "actionSlug": "<string>",
        "name": "<string>",
        "description": "<string>",
        "retry": {
          "maximumAttempts": 123,
          "initialInterval": 123,
          "backoffCoefficient": 123
        },
        "fallbackChildUuid": "<string>"
      }
    ],
    "batchUuid": "<string>",
    "temporalWorkflowId": "<string>",
    "recordId": "<string>",
    "recordTitle": "<string>",
    "contextS3Filename": "<string>",
    "computedConfigsS3Filename": "<string>",
    "parentUuid": "<string>",
    "parentNodeUuid": "<string>",
    "parentBatchUuid": "<string>",
    "parentAgentUuid": "<string>",
    "parentChatUuid": "<string>",
    "parentMessageUuid": "<string>",
    "isGroupParent": true,
    "status": "idle",
    "errorMessage": "<string>",
    "executions": [
      {
        "nodeUuid": "<string>",
        "nodeSlug": "<string>",
        "nodeBatchUuid": "<string>",
        "nodeRunUuid": "<string>",
        "nodeMessageUuid": "<string>",
        "nodeChildIndex": 123,
        "nextNodeUuid": "<string>",
        "status": "pending",
        "errorMessage": "<string>",
        "title": "<string>",
        "iconUrl": "<string>",
        "creditsUsedCount": 123,
        "nodeKind": "<string>",
        "nodeActionSlug": "<string>"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "finishedAt": "<string>",
    "deletedAt": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body schema.

workflowUuid
string
required

Workflow identifier.

data
any
required

Input data for the run.

releaseUuid
string

Release identifier to run.

Response

Successful response

run
Run · object
required

Created run details.