List Tool Calls | BCTRL Docs

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

{
  "data": [
    {
      "actor": "test",
      "createdAt": "2024-06-01T12:00:00Z",
      "durationMs": 350,
      "finishedAt": "2024-06-01T12:05:50Z",
      "id": "a3f1c2d4-5678-4e9a-b123-9f8e7d6c5b4a",
      "spaceId": "d9876543-21fe-4cba-9876-54321fedcba0",
      "startedAt": "2024-06-01T12:00:00Z",
      "status": "failed",
      "tool": {
        "executionType": "webhook",
        "id": "e4567890-abcd-4ef0-1234-56789abcdef0",
        "name": "data_processor"
      },
      "error": {
        "code": "ERR_TIMEOUT",
        "message": "The tool execution timed out after 30 seconds.",
        "details": {
          "timeoutSeconds": 30,
          "retry": false
        }
      },
      "inputSummary": {
        "param1": "value1",
        "param2": 42,
        "flag": true
      },
      "invocationId": "b7e9f8a1-2345-4cde-9f12-3456789abcde",
      "outputSummary": {
        "result": "success",
        "itemsProcessed": 100
      },
      "runId": "c1234567-89ab-4def-0123-456789abcdef",
      "toolsetId": "f1234567-89ab-4cde-0123-456789abcdef"
    }
  ],
  "nextCursor": "eyJwYWdlIjoyLCJsaW1pdCI6MjB9"
}

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

spaceIdstringRequiredformat: "uuid"

limitintegerOptional<=200

cursorstringOptional1-1000 characters

toolIdstringOptionalformat: "uuid"

runIdstringOptionalformat: "uuid"

invocationIdstringOptionalformat: "uuid"

statusenumOptional

Allowed values:

actorenumOptional

Allowed values:

Response

Default Response

datalist of objects

nextCursorstring or null