Insert article visual block
insert_article_visual_blockYou 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
Insert an uploaded inline image or owned Prism artifact into an active Writing Studio draft at the start, end, or a stable text marker such as [[visual:revenue-chart]]. Requires expectedUpdatedAt and cannot publish, schedule, delete, fetch remote images, or update published posts.
View JSON Schema
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"block": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "inline_image"
},
"imageUrl": {
"type": "string",
"maxLength": 2048,
"description": "Inline image URL returned by upload_article_image for this draft."
},
"alt": {
"type": "string",
"maxLength": 240
},
"caption": {
"type": "string",
"maxLength": 300
}
},
"required": [
"type",
"imageUrl"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "artifact"
},
"artifactId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"type",
"artifactId"
],
"additionalProperties": false
}
]
},
"placement": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "start"
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "end"
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "replace_marker"
},
"marker": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Stable marker already present in the draft body, for example [[visual:revenue-chart]]."
},
"occurrence": {
"type": "number",
"minimum": 1,
"description": "1-based marker occurrence when the same marker appears more than once."
}
},
"required": [
"type",
"marker"
],
"additionalProperties": false
}
]
}
},
"required": [
"documentId",
"expectedUpdatedAt",
"block",
"placement"
],
"additionalProperties": false
}