List Run Invocations

curl https://api.bctrl.ai/v1/runs/runId/invocations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "action": "act",
      "createdAt": "2024-06-10T15:22:30Z",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "runId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "runtimeId": "1c6b147a-8f3a-4d2a-9f3e-2a1b5c4d7e8f",
      "status": "failed",
      "durationMs": 350,
      "error": {
        "message": "Invocation exceeded the maximum allowed duration.",
        "code": "invocation.timeout",
        "details": {
          "timeoutSeconds": 30,
          "step": "fetchData"
        }
      },
      "finishedAt": "2024-06-10T15:22:35Z"
    }
  ],
  "nextCursor": "eyJpZCI6IjNmYTg1ZjY0NTcxNzQ1NjJiM2ZjMmM5NjNmNjZhZmE2In0"
}

List the invocations a run produced using the simplified response envelope. This is the observability view over invocation history.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runIdstringRequired

Query parameters

statusenum or list of enumsOptional

actionenum or list of enumsOptional

cursorstringOptional>=1 character

limitintegerOptional<=200Defaults to 50

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error