Public A P I
Deactivate Agent
Deactivate an agent. This is a soft delete: the agent can no longer start new runs, but its existing runs and their results remain retrievable.
Authorization
BearerAuth AuthorizationBearer <token>
In: header
Path Parameters
agent_id*Agent Id
Web Search Agent ID, format wsa_<uuid>.
Format
uuidResponse Body
application/json
application/json
curl -X DELETE "https://example.com/v2/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"Empty
Update Agent PATCH
Update an agent with a [JSON Patch](https://datatracker.ietf.org/doc/html/rfc6902) document — an array of `{op, path, value}` operations applied to the agent, e.g. `[{"op": "replace", "path": "/display_name", "value": "My agent"}]`. Returns the updated agent.
List Agent Runs GET
List the runs of an agent, newest first, paginated with `offset`/`limit`.