Skip to main content
POST
Call a connected app's tool

Authorizations

Authorization
string
header
required

Agent token (alt_…) or OAuth access token; bound to one agent

Path Parameters

accountId
string
required

Connected account id (cna_…)

Body

application/json
tool
string
required

Tool name exactly as list_connector_tools returns it

Required string length: 1 - 128
arguments
object

Tool arguments as a JSON object matching the tool's input_schema

idempotency_key
string

Pass one for every call that changes state. Repeating the same call with the same key within 24 hours returns the first result without calling the tool again; another call under the key, or a repeat while the first still runs, is refused

Required string length: 1 - 200

Response

Tool result

request_id
string
is_error
boolean
content
object[]
structured_content
any
truncated
boolean
duration_ms
integer
replayed
boolean

The stored result of an earlier call with the same idempotency_key