Unpublishes an agent and returns the updated agent. Unpublishing halts the agent's real-time interactions, and its configuration, associated datasets, and monitoring policies stay intact and editable.

When to use it

Use it to take an agent down for maintenance, guardrail changes, or logic fixes without archiving or deleting it. Publish again with Create an agent version when it is ready.

Required parameters

• agent_id (path): the ID of the agent.

Response

A successful call returns 200 OK with the updated Agent object, including its status and url.

Related: Deactivate an agent, Activate an agent, Create an agent version