Skip to main content
GET
Get Disposition Draft

Overview

Dispositions are enabled per organization. If your organization does not have access, these endpoints return 404.
Returns the editable draft definition and its current revision. Send that revision back as expectedDraftRevision when you call Update Disposition Draft or Publish Disposition. Compare the draft against its published base with Get Disposition Version.

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

string
The disposition this draft belongs to.
number
The draft’s current revision. Every draft update and publish increments it.
string | null
The most recently published version, which is the base this draft is edited against. null if the disposition has never been published.
object
The draft definition. Same shape as the definition body parameter of Create Disposition.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt