Get Tool Call | BCTRL Docs

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

{
  "actor": "invocation",
  "createdAt": "2024-06-10T15:22:30Z",
  "durationMs": 245,
  "finishedAt": "2024-06-10T15:22:30Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "startedAt": "2024-06-10T15:22:25Z",
  "status": "failed",
  "tool": {
    "executionType": "webhook",
    "id": "1c6f8e2a-3b4d-4f7a-9a2b-123456789abc",
    "name": "data_fetcher"
  },
  "toolCallId": "call_20240610_152225_001",
  "error": {
    "code": "tool.timeout",
    "message": "The tool execution timed out after 30 seconds.",
    "details": {
      "timeoutSeconds": 30,
      "attempt": 1
    }
  },
  "inputSummary": {
    "query": "fetch user data",
    "userId": "12345"
  },
  "invocationId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
  "outputSummary": {
    "resultCount": 10,
    "status": "partial"
  },
  "redactedError": null,
  "redactedInput": null,
  "redactedOutput": null,
  "runId": "9b2d7f4e-8c3a-4f1a-9d2e-1a2b3c4d5e6f",
  "toolsetId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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

Response

actorenum

createdAtstring

durationMsinteger0-9007199254740991

finishedAtstring

idstringformat: "uuid"

spaceIdstringformat: "uuid"

startedAtstring

statusenum

toolobject

toolCallIdstring1-120 characters

errorobject or null

inputSummaryobject or null

invocationIdstring or nullformat: "uuid"

outputSummaryobject or null

redactedErrorobject or null

redactedInputany

Any valid JSON value: object, array, string, number, boolean, or null.

redactedOutputany

Any valid JSON value: object, array, string, number, boolean, or null.

runIdstring or nullformat: "uuid"

toolsetIdstring or nullformat: "uuid"

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error