agent_desk

Put Control Document

Save-and-activate a manual edit: appends a new version (source "manual") and makes it the active one. This is the point where the control-document surface goes live for a domain — until the first PUT, desk prompts are byte-identical to today's.

put/api/domains/{domain_id}/agent-desk/control-documents/{kind}

Request

  • Base URL
    https://api-v1.unusual.ai (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Path parameters

kind'knowledge' | 'policy' required
domain_idstring required

Headers

x-view-asstring nullable

Request body

markdownstring required
change_summarystring nullable

Response

Successful Response

kindstring required
active_version_numberinteger nullable
active_markdownstring nullable
version_countinteger
updated_atstring nullable
char_budgetinteger nullable
compiling_sincestring nullable
human_editedboolean
proposed_version_countinteger
latest_proposed_version_numberinteger nullable
servingboolean
always_onboolean

Changes

No recorded changes to this operation across all 1 revision of this API.