Get Tool Call | BCTRL Docs

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

{
  "actor": "agent",
  "createdAt": "2024-06-10T15:22:30Z",
  "durationMs": 245,
  "finishedAt": "2024-06-10T15:22:30.245Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spaceId": "9b2d7f4e-8c3a-4f1b-9d2e-7a6c5b4e3f21",
  "startedAt": "2024-06-10T15:22:30.000Z",
  "status": "failed",
  "toolCallId": "call_20240610_152230",
  "toolExecutionType": "webhook",
  "toolId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "toolName": "data_fetcher",
  "error": {
    "code": "timeout_error",
    "message": "The tool execution timed out after 30 seconds.",
    "details": {
      "timeoutSeconds": 30,
      "retryCount": 2
    }
  },
  "inputSummary": {
    "query": "fetch user data",
    "parameters": {
      "userId": "12345"
    }
  },
  "invocationId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "outputSummary": {
    "resultCount": 1,
    "status": "partial"
  },
  "runId": "1c6b147e-3f3a-4d2a-9f3a-8a1b2c3d4e5f",
  "toolsetId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

Get one tool call audit record with timing, status, summaries, and error details when available. Use this to debug a specific tool execution.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

toolCallIdstringRequired

Response

Default Response

actorenum

Allowed values:

createdAtstring

durationMsinteger0-9007199254740991

finishedAtstring

idstringformat: "uuid"

spaceIdstringformat: "uuid"

startedAtstring

statusenum

Allowed values:

toolCallIdstring1-120 characters

toolExecutionTypeenum

Allowed values:

toolIdstringformat: "uuid"

toolNamestringformat: "^[a-z_][a-z0-9_-]*$"1-64 characters

errorobject or null

inputSummarymap from strings to any or null

invocationIdstring or nullformat: "uuid"

outputSummarymap from strings to any or null

runIdstring or nullformat: "uuid"

toolsetIdstring or nullformat: "uuid"