Get tool executions

$	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

Get tool executions

Path parameters

Headers

Query parameters

Response

Errors

Path parameters

Headers

Query parameters

Response

Errors

1	{
2	"executions": [
3	{
4	"tool_id": "string",
5	"tool_request_id": "string",
6	"conversation_id": "string",
7	"agent_id": "string",
8	"timestamp": 1.1,
9	"latency_secs": 1.1,
10	"id": "string",
11	"branch_id": "string",
12	"is_error": false,
13	"request_payload": "string",
14	"response_payload": "string",
15	"error_message": "string",
16	"error_type": "string",
17	"tool_call_details": {
18	"type": "webhook",
19	"method": "string",
20	"url": "string",
21	"body": "string",
22	"headers": {},
23	"path_params": {},
24	"query_params": {}
25	}
26	}
27	],
28	"has_more": true,
29	"next_cursor": "string"
30	}