Create Invocation | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/spaces/id/runtimes/runtimeId/invocations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "input": {
    "instruction": "string"
  },
  "operation": "string",
  "provider": "string"
}'

{
  "artifactCount": 1,
  "createdAt": "string",
  "entryCall": "string",
  "executionMode": "inline",
  "id": "string",
  "runId": "string",
  "runtimeId": "string",
  "runtimeKind": "browser",
  "sequenceNo": 1,
  "spaceId": "string",
  "status": "queued",
  "stepCount": 1,
  "cancelRequestedAt": "string",
  "connector": "string",
  "correlationId": "string",
  "durationMs": 1,
  "error": {
    "message": "string",
    "code": "string",
    "details": {}
  },
  "finishedAt": "string",
  "lastHeartbeatAt": "string",
  "metadata": {},
  "progress": {
    "currentCall": "string",
    "lastEventType": "string",
    "message": "string",
    "step": 1,
    "totalSteps": 1
  },
  "request": {
    "runtimeId": "string",
    "steps": [
      {
        "call": "string",
        "args": [
          null
        ],
        "bind": "string",
        "options": {
          "dryRun": true,
          "timeoutMs": 1
        },
        "ref": "string"
      }
    ],
    "idempotencyKey": "string",
    "mode": "string"
  },
  "result": {
    "mode": "string",
    "ok": true,
    "runtimeId": "string",
    "steps": [
      {
        "binding": {
          "alias": "string",
          "id": "string",
          "type": "page"
        },
        "call": "string",
        "index": 1,
        "ok": true,
        "resolved": {
          "call": "string",
          "contextId": "string",
          "handleId": "string",
          "method": "string",
          "pageId": "string",
          "ref": "string",
          "runtimeId": "string",
          "target": "string"
        }
      }
    ]
  },
  "startedAt": "string"
}

Submit durable AI work to a live runtime. Use invocations for agent execution such as Stagehand or browser-use work that needs lifecycle tracking.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

runtimeIdstringRequired

Request

This endpoint expects an object.

objectRequired

Response

Default Response

artifactCountinteger0-9007199254740991

createdAtstring

entryCallstring>=1 character

executionModeenum

Allowed values:

idstringformat: "uuid"

runIdstringformat: "uuid"

runtimeIdstringformat: "uuid"

runtimeKindenum

Allowed values:

sequenceNointeger<=9007199254740991

spaceIdstringformat: "uuid"

statusenum

stepCountinteger<=9007199254740991

cancelRequestedAtstring or null

connectorstring or null>=1 character

correlationIdstring or null

durationMsinteger or null0-9007199254740991

errorobject or null

finishedAtstring or null

lastHeartbeatAtstring or null

metadatamap from strings to any or null

progressobject or null

requestobject or null

resultobject or null

startedAtstring or null