Agents
Create, configure and inspect AI agents, their activity and their runs.
Create Agent
Create an agent in the key's workspace and return the full record, prompts included.
List Agents
List the workspace's agents with their basic settings. Platform templates are not included.
Get Agent Activity
Summarise what the agent did over a time window: messages sent, documents created, calls placed.
List Agent Traces
List recent runs of the agent, newest first, with status and duration. Pass a run's id to the run detail endpoint for the full timeline.
Get Agent Trace
Return one run in full: the steps taken, timeline of events and model calls with their errors. Prompts and message bodies are never included.
Get Agent
Return one agent with its full configuration, including prompt text.
Update Agent
Change any subset of an agent's settings. Fields left out of the body keep their current value; to clear a field, send its empty value explicitly where the field allows it.
Delete Agent
Delete an agent. Answers 409 while the agent is on a live call (hang it up first) and 409 for a platform template, which cannot be deleted.
List Triggers
List the triggers attached to an agent, in the order they are evaluated.
Create Trigger
Attach a trigger to an agent and return it.
Update Trigger
Update a trigger. Fields you leave out keep their current value.
Delete Trigger
Detach a trigger. The agent stops answering on whatever the trigger covered.