Get Tool Call | BCTRL Docs

curl -G https://api.bctrl.ai/v2/tool-calls/id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d spaceId=spaceId

{
  "actor": "invocation",
  "createdAt": "2024-06-10T15:22:30Z",
  "durationMs": 245,
  "finishedAt": "2024-06-10T15:22:30Z",
  "id": "call_9f8b7c6d-1234-4a56-8e9f-abcdef123456",
  "spaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "startedAt": "2024-06-10T15:22:25Z",
  "status": "succeeded",
  "tool": {
    "executionType": "hosted_function",
    "id": "a12b34cd-56ef-78ab-90cd-ef1234567890",
    "name": "data_processor"
  },
  "error": null,
  "inputSummary": {
    "userId": "user_7890",
    "action": "start_process",
    "parameters": {
      "priority": "high",
      "timeout": 300
    }
  },
  "invocationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "outputSummary": {
    "result": "success",
    "processedItems": 42
  },
  "runId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
  "toolsetId": "b123c456-d789-0123-e456-7890abcdef12"
}

Get one tool call audit record by the same tool call id that appears in webhook payloads and run events.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

spaceIdstringRequiredformat: "uuid"

Response

Default Response

actorenum

Allowed values:

createdAtstring

durationMsinteger0-9007199254740991

finishedAtstring

idstring1-120 characters

spaceIdstringformat: "uuid"

startedAtstring

statusenum

Allowed values:

toolobject

errorobject or null

inputSummaryobject or null

invocationIdstring or nullformat: "uuid"

outputSummaryobject or null

runIdstring or nullformat: "uuid"

toolsetIdstring or nullformat: "uuid"