List Conversation Tool Calls

get

https://connect.agendapro.com/v3/conversations/{id}/tool_calls

This endpoint returns the actions (tool calls) that the Cortex agent ran in a conversation, oldest first.

Requires conversations:read scope.
{id} is a conversation of a lead (GET /v3/leads/{id}/conversations). A conversation of another company responds 404, the same as one that does not exist.
Only the agent's tools are listed (booking, rescheduling, cancelling and the external booking functions, among others); system notes of the conversation are not.
booking_ids are the bookings the action created, moved or cancelled. It is empty when the tool does not operate bookings or failed, and has several ids for a multi-service booking.
args and result are returned exactly as Cortex stored them. A failed call has status: error, result: null and the stored message in error.
If Cortex could not record an action (its notes are written without confirmation), that action is not listed.

Status	Error	Detail	Description
400	invalid_format	limit	`limit` is not an integer.
400	invalid_range	limit	`limit` is out of the allowed range.
400	invalid_format	cursor	`cursor` is not a cursor returned by this list.
400	invalid_params	params	Another parameter is invalid.
401	unauthorized	invalid_api_key	Missing or invalid Bearer token.
401	unauthorized	api_config_inactive	API access is inactive for this company.
403	forbidden	scope_denied	API key lacks `conversations:read` scope.
403	forbidden	company_not_enabled	The company is not enabled to read Cortex data through this API. Contact AgendaPro to enable it; retrying does not help.
404	not_found	conversation	Conversation not found, or it belongs to another company.
429	rate_limited	burst_limit_exceeded	Per-minute request limit exceeded.
429	rate_limited	daily_quota_exceeded	Daily request quota exceeded.
502	upstream_unavailable		The upstream service is unavailable.
502	upstream_unavailable	upstream_misconfigured	AgendaPro's internal connection to Cortex is misconfigured. It is not a problem with your API key; retry later or contact support.
502	upstream_unavailable	upstream_error	Cortex answered an error. Retry the same request later.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200Cursor-paginated list of tool calls.