List Tool Calls | BCTRL Docs

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

{
  "data": [
    {
      "actor": "test",
      "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:18:25Z",
      "status": "failed",
      "tool": {
        "executionType": "webhook",
        "id": "9b2d7f3a-4c5e-4f6a-8b7c-1d2e3f4a5b6c",
        "name": "data_fetcher"
      },
      "toolCallId": "call_20240610_152225",
      "error": {
        "code": "timeout_error",
        "message": "The tool execution timed out after 30 seconds.",
        "details": {
          "timeoutSeconds": 30,
          "retryable": true
        }
      },
      "inputSummary": {
        "query": "fetch user data",
        "parameters": {
          "userId": "12345"
        }
      },
      "invocationId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "outputSummary": {
        "resultCount": 10,
        "status": "partial"
      },
      "redactedError": null,
      "redactedInput": null,
      "redactedOutput": null,
      "runId": "1c6b147e-3f4a-4d2a-9f3a-8a1b2c3d4e5f",
      "toolsetId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ],
  "nextCursor": "eyJpZCI6IjNmYTg1ZjY0NTcxNzQ1NjJiM2ZjMmM5NjNmNjZhZmE2In0"
}

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>.

Query parameters

spaceIdstring or "default"Optional

toolIdstringOptionalformat: "uuid"

runIdstringOptionalformat: "uuid"

invocationIdstringOptionalformat: "uuid"

statusenumOptional

Allowed values:

actorenumOptional

Allowed values:

cursorstringOptional>=1 character

limitintegerOptional<=200Defaults to 50

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error