Wait for Invocation | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/invocations/id/wait \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "invocation": {
    "artifactCount": 3,
    "createdAt": "2024-06-01T12:40:00Z",
    "entryCall": "processData",
    "executionMode": "durable",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "runId": "4b825dc6-8a1a-4f3a-9f3e-2a1b3c4d5e6f",
    "runtimeId": "1e2d3c4b-5a6f-7e8d-9c0b-1a2b3c4d5e6f",
    "runtimeKind": "browser",
    "sequenceNo": 42,
    "spaceId": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
    "status": "running",
    "stepCount": 5,
    "cancelRequestedAt": "2024-06-01T12:45:30Z",
    "connector": "aws-lambda",
    "correlationId": "corr-1234567890abcdef",
    "durationMs": 3500,
    "error": {
      "message": "Invocation timed out after 3.5 seconds",
      "code": "TIMEOUT",
      "details": {}
    },
    "finishedAt": "2024-06-01T12:40:03Z",
    "lastHeartbeatAt": "2024-06-01T12:40:02Z",
    "metadata": {},
    "progress": {
      "currentCall": "fetchUserData",
      "lastEventType": "step_completed",
      "message": "Step 2 of 5 completed",
      "step": 2,
      "totalSteps": 5
    },
    "request": {
      "runtimeId": "1e2d3c4b-5a6f-7e8d-9c0b-1a2b3c4d5e6f",
      "steps": [
        {
          "call": "initializeSession",
          "args": [
            null
          ],
          "bind": "step1",
          "options": {
            "dryRun": false,
            "timeoutMs": 30000
          },
          "ref": "initRef"
        }
      ],
      "idempotencyKey": "abc123xyz789",
      "mode": "fail-fast"
    },
    "result": {
      "mode": "fail-fast",
      "ok": true,
      "runtimeId": "1e2d3c4b-5a6f-7e8d-9c0b-1a2b3c4d5e6f",
      "steps": [
        {
          "binding": {
            "alias": "mainPage",
            "id": "page-987654321",
            "type": "page"
          },
          "call": "renderDashboard",
          "index": 0,
          "ok": true,
          "resolved": {
            "call": "renderDashboard",
            "contextId": "ctx-1234abcd",
            "handleId": "handle-5678efgh",
            "method": "GET",
            "pageId": "page-987654321",
            "ref": "ref-001",
            "runtimeId": "1e2d3c4b-5a6f-7e8d-9c0b-1a2b3c4d5e6f",
            "target": "browser"
          }
        }
      ]
    },
    "startedAt": "2024-06-01T12:39:59Z"
  },
  "timedOutWaiting": false
}

Wait for a durable invocation to finish or until the wait times out. Use this when a caller wants completion without polling.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Request

This endpoint expects an object.

timeoutMsintegerOptional<=600000

Response

Default Response

invocationobject

timedOutWaitingboolean