Get tool executions

GET

/v1/convai/tools/:tool_id/executions

GET

/v1/convai/tools/:tool_id/executions

$ curl -G https://api.elevenlabs.io/v1/convai/tools/tool_id/executions \
>      -d cursor=cursor \
>      -d page_size=1 \
>      -d is_error=true \
>      -d agent_id=agent_id \
>      -d branch_id=branch_id \
>      -d start_time=1.1 \
>      -d end_time=1.1

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

Get paginated list of tool executions for a specific tool.

Path parameters

tool_idstringRequired

ID of the requested tool.

Query parameters

cursorstringOptional

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_errorbooleanOptional

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

agent_idstringOptional

Filter by agent ID.

branch_idstringOptional

Filter by agent branch ID.

start_timedoubleOptional

Filter executions from this Unix timestamp (inclusive).

end_timedoubleOptional

Filter executions until this Unix timestamp (inclusive).

Response

Successful Response

executionslist of objects

has_moreboolean

next_cursorstring

Errors

422

Executions Get Request Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors