Agents
Update agent
Update an agent's mutable fields. Changing slug (the agent handle segment) requires a non-delegated user session on an active, verified party; renaming or clearing a slug releases the previous value into a 14-day hold.
patch/agents/{agentId}
Path parameters
agentIdstring required
Agent ID
Headers
Idempotency-Keystring required
Unique key for idempotent request handling. If a request with the same key was already processed, the original response is returned.
X-Agent-IDstring nullable
Agent ID (agt_xxx) identifying which agent is making the request.
X-Instance-IDstring nullable
Required when X-Agent-ID is present. Session or conversation ID for agent observability.
Request body
Response
Successful Response