List Tool Calls | BCTRL Docs

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

{
  "toolCalls": [
    {
      "actor": "agent",
      "createdAt": "2024-06-15T12:34:56Z",
      "durationMs": 2450,
      "finishedAt": "2024-06-15T12:34:58Z",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "spaceId": "9f8c7d6e-5b4a-3c2d-1e0f-123456789abc",
      "startedAt": "2024-06-15T12:34:55Z",
      "status": "failed",
      "toolCallId": "call_20240615_123455",
      "toolExecutionType": "webhook",
      "toolId": "2a4f6b8c-9d0e-4f1a-b2c3-4d5e6f7a8b9c",
      "toolName": "data_fetcher",
      "error": {
        "code": "timeout_error",
        "message": "The tool execution timed out after 30 seconds.",
        "details": {
          "timeoutSeconds": 30,
          "retry": false
        }
      },
      "inputSummary": {
        "query": "fetch user data",
        "parameters": {
          "userId": "12345"
        }
      },
      "invocationId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
      "outputSummary": {
        "resultCount": 0,
        "error": "timeout"
      },
      "runId": "1c6b147e-8f3a-4d2a-9f3e-2a1b9f7c8d3e",
      "toolsetId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a"
    }
  ],
  "nextCursor": "eyJjdXJzb3IiOiIyMDIzMDYxNVQxMjM0NTZaIn0="
}

List audit records for tool executions from tests and agent invocations. Use filters such as tool, run, invocation, status, or actor to debug what happened.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

limitintegerOptional<=200

cursorstringOptional1-1000 characters

toolIdstringOptionalformat: "uuid"

runIdstringOptionalformat: "uuid"

invocationIdstringOptionalformat: "uuid"

statusenumOptional

Allowed values:

actorenumOptional

Allowed values:

Response

Default Response

toolCallslist of objects

nextCursorstring or null