ToolWrite

Revise writing object

revise_writing_object

Create or revise a private Writing Studio draft while keeping publishing decisions inside Prism.

When to use it

You need to create, inspect, revise, cite, or add images to article drafts.

Typical workflow

List or read drafts, make complete replacement edits with optimistic concurrency, and insert visual blocks at stable markers.

What it returns

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 JSON Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "execute",
        "preview",
        "commit"
      ]
    },
    "payload": {
      "type": "object"
    },
    "idempotencyKey": {
      "type": "string"
    },
    "operationId": {
      "type": "string",
      "format": "uuid"
    },
    "commitToken": {
      "type": "string"
    }
  },
  "required": [
    "action",
    "mode"
  ],
  "additionalProperties": false
}

Useful next tools

Insert article visual blockinsert_article_visual_blockAttach article sourceattach_article_sourcePlan visualization artifactplan_visualization_artifact