Skip to main content
POST
Disable Disposition

Overview

Dispositions are enabled per organization. If your organization does not have access, these endpoints return 404.
Sets state to disabled so the disposition no longer runs on new completed calls. The request takes no body. The draft, version history, and publishedVersionId are left untouched, and test runs still work. There is no separate enable call: to turn it back on, publish the draft again, which creates a new version and sets state to enabled. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier. Must be a UUID; otherwise returns 400 with the message agentId must be a valid UUID. Returns 404 Agent not found if the agent is not in your organization.
string
required
The disposition’s unique identifier. Must be a UUID; otherwise returns 400 with the message dispositionId must be a valid UUID. Returns 404 Disposition not found if it does not belong to this agent.

Response

object
The updated disposition summary.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt