Upload article image
upload_article_imageYou 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
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
Upload a generated image into an active Writing Studio draft as either the cover image or an inline image block. For precise inline placement, pass the returned imageUrl to insert_article_visual_block. Accepts base64 image bytes only; does not fetch remote URLs, publish, schedule, delete, or send emails.
View JSON Schema
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"format": "uuid"
},
"placement": {
"type": "string",
"enum": [
"cover",
"inline"
]
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"mimeType": {
"type": "string",
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
]
},
"imageBase64": {
"type": "string",
"description": "Base64 encoded image bytes. Use either imageBase64 or dataUrl, not both."
},
"dataUrl": {
"type": "string",
"description": "Base64 image data URL such as data:image/png;base64,... Use either dataUrl or imageBase64, not both."
},
"alt": {
"type": "string",
"maxLength": 240
},
"caption": {
"type": "string",
"maxLength": 300
}
},
"required": [
"documentId",
"placement",
"filename",
"mimeType"
],
"additionalProperties": false
}