Get tool executions | ElevenLabs Documentation

1	curl https://api.elevenlabs.io/v1/convai/tools/tool_id/executions

{
  "executions": [
    {
      "tool_id": "string",
      "tool_request_id": "string",
      "conversation_id": "string",
      "agent_id": "string",
      "timestamp": 1.1,
      "latency_secs": 1.1,
      "id": "string",
      "branch_id": "string",
      "is_error": false,
      "request_payload": "string",
      "response_payload": "string",
      "error_message": "string",
      "error_type": "string",
      "tool_call_details": {
        "type": "webhook",
        "method": "string",
        "url": "string",
        "body": "string",
        "headers": {},
        "path_params": {},
        "query_params": {}
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Get paginated list of tool executions for a specific tool.

Path parameters

tool_idstringRequired

ID of the requested tool.

Query parameters

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

page_sizeintegerOptional1-100Defaults to 30

How many documents to return at maximum. Can not exceed 100, defaults to 30.

is_errorboolean or nullOptional

Filter by error status. If not provided, returns all executions.

agent_idstring or nullOptional

Filter by agent ID.

branch_idstring or nullOptional

Filter by agent branch ID.

start_timedouble or nullOptional

Filter executions from this Unix timestamp (inclusive).

end_timedouble or nullOptional

Filter executions until this Unix timestamp (inclusive).

Response

Successful Response

executionslist of objects

has_moreboolean

next_cursorstring or null

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors