Update article draft
update_article_draftYou need to create, inspect, revise, cite, or add images to article drafts.
When to use it
You need to create, inspect, revise, cite, or add images to article drafts.
List or read drafts, make complete replacement edits with optimistic concurrency, and insert visual blocks at stable markers.
Draft metadata, editable draft bodies, update timestamps, embeds, or image blocks.
Avoid using it when
Do not call without first reading the latest draft body and updatedAt.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Revise an active owned Writing Studio article draft. For AI-generated prose, prefer contentText with Markdown; use rich content only when preserving an existing Prism rich document. Pass expectedUpdatedAt for optimistic locking, or force true for explicit one-writer agent workflows. Cannot publish, schedule, delete, or update published posts. Avoid when: Do not call without first reading the latest draft body and updatedAt.
View JSON Schema
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"force": {
"type": "boolean",
"default": false,
"description": "Explicitly bypass optimistic locking for one-writer agent workflows. Use sparingly; Prism records forced true in audit metadata."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"subtitle": {
"type": [
"string",
"null"
],
"maxLength": 240
},
"content": {
"type": "object",
"description": "Complete formatted body replacement as canonical TipTap content, raw TipTap doc JSON, or legacy Prism quill-delta. Reads return canonical TipTap content."
},
"contentText": {
"type": "string",
"description": "Recommended for AI-generated prose. Markdown pipe tables become structured table artifact embeds; Markdown ##/### headings become Writing Studio H2/H3 blocks; simple **bold** spans become bold rich text. Use the title field for the article title instead of a body # heading."
},
"disclosureText": {
"type": [
"string",
"null"
],
"maxLength": 2000
},
"coverImageUrl": {
"type": [
"string",
"null"
],
"maxLength": 2048
}
},
"required": [
"documentId"
],
"additionalProperties": false
}