Get article draft for editing
get_article_draft_for_editRead before any update_article_draft call so you can preserve content and pass expectedUpdatedAt.
When to use it
Read before any update_article_draft call so you can preserve content and pass expectedUpdatedAt.
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
You need to publish, schedule, delete, or email a post; those are human-only.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Read one owned Writing Studio article draft with full rich editor content, plain text, citations, and updatedAt for safe MCP revisions. Requires explicit draft write permission. Use when: Read before any update_article_draft call so you can preserve content and pass expectedUpdatedAt.
View JSON Schema
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"documentId"
],
"additionalProperties": false
}