POST /agent/draft
Patch Agent Draft
Patch agent draft — composable infra architecture.
Request Body (PatchAgentDraftApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
draft_id | string | No | UUID of the draft to update |
group_id | string | No | UUID of the owning group |
input_draft_id | string | No | UUID of the input draft |
idempotency_key | string | No | Idempotency key for accept/reject acknowledgement |
soft | boolean | No | Stage the draft dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it |
accept | boolean | No | Whether pending changes should be accepted |
name | string | No | Display name value |
name_id | string | No | UUID of the name resource |
description | string | No | Description text value |
description_id | string | No | UUID of the description resource |
flag_ids | string[] | No | Selected flag option UUIDs — canonical |
active | boolean | No | Denormalized agent_active flag state; resolved to a flag_ids entry server-side |
departments | string[] | No | Department names for matching |
department_ids | string[] | No | Associated department UUIDs |
model_id | string | No | Associated model UUID |
tool_ids | string[] | No | Associated tool UUIDs |
reasoning_level | string | No | Reasoning level label to match |
reasoning_level_id | string | No | Associated reasoning level UUID |
temperature_level | string | No | Temperature level label to match |
temperature_level_id | string | No | Associated temperature level UUID |
voices | string[] | No | Voice names for matching or creation |
voice_ids | string[] | No | Associated voice UUIDs |
qualities | string[] | No | Quality labels for matching |
quality_ids | string[] | No | Associated quality UUIDs |
prompt_id | string | No | Associated prompt UUID |
prompt | CreatePromptInput | No | Prompt to create inline |
instruction_id | string | No | Associated instruction UUID |
instructions_id | string | No | Legacy alias for associated instruction UUID |
rubric_ids | string[] | No | Associated rubric UUIDs |
pending_ids | string[] | No | Pending resource identifiers |
Response (PatchAgentDraftApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Yes | Whether the operation succeeded |
draft_id | string | Yes | UUID of the saved draft |
idempotency_key | string | No | Idempotency key for accept/reject acknowledgement |
message | string | Yes | Human-readable result message |
form_state | app__infra__agent__types__DraftFormState | No | Server-authoritative form state |
Last updated on