Get a tool
Agents
Get a tool
GET
Get a tool
Authorizations
Use Authorization: Bearer pyai_live_... (or pyai_test_...).
Path Parameters
Response
Tool
Example:
"tool"
Available options:
prebuilt, custom Customer settings this tool needs to run. Render as a form in your builder; save answers on the agent binding config.
How the tool runs. hosted = PyAI runs it (prebuilt read catalog). server = the tool-executor calls your webhook. engine = the Omni call engine runs it natively (call control: transfer_to_human, send_dtmf, play_hold, collect, end_call), not routed to the executor. client = your connected app.
Available options:
hosted, server, engine, client Whether a webhook auth secret is configured (the secret itself is never returned).
Available options:
read, action Available options:
active, disabled