Create run | Plextera Public API

curl -X POST https://api.dev.plextera.com/api/public/v1/workflows/workflowId/runs \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "id": "string",
  "status": "PROCESSING",
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "startedAt": "2024-01-15T09:30:00Z",
  "completedAt": "2024-01-15T09:30:00Z",
  "error": {
    "code": "string",
    "message": "string"
  },
  "workflow": {
    "id": "string",
    "name": "string"
  },
  "progress": {
    "stepsCompleted": 1,
    "stepsTotal": 1
  },
  "durationMs": 1,
  "computedDurationMs": 1,
  "steps": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "status": "QUEUED",
      "message": "string",
      "output": null,
      "nestedRuns": {
        "count": 1,
        "data": [
          {
            "id": "string",
            "status": "PROCESSING",
            "createdAt": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z",
            "startedAt": "2024-01-15T09:30:00Z",
            "completedAt": "2024-01-15T09:30:00Z",
            "error": {
              "code": "string",
              "message": "string"
            },
            "workflow": {
              "id": "string",
              "name": "string"
            },
            "progress": {
              "stepsCompleted": 1,
              "stepsTotal": 1
            },
            "durationMs": 1,
            "computedDurationMs": 1,
            "steps": [
              null
            ]
          }
        ]
      }
    }
  ]
}

Authentication

Authorizationstring

Use the API key format: api-key <token>.

Path parameters

workflowIdstringRequired

Request

Workflow trigger payload. Any valid JSON value is accepted and interpreted by the target workflow.

Response

Accepted

idstring

statusenum

Allowed values:

createdAtdatetime

updatedAtdatetime

startedAtdatetime

completedAtdatetime

errorobject

Terminal failure details. Present only for failed or rejected jobs and runs.

workflowobject

progressobject

durationMslong

computedDurationMslong

stepslist of objects