Narrareach

Preview or amend queued LinkedIn post text

amend_scheduled_note_content

DestructiveIdempotent

Preview or replace the text of an untouched queued LinkedIn post while preserving its images and supported videos using its scheduled Note id and exact current revision. Changes the queued delivery snapshot, not a shared draft. apply defaults to false for a non-mutating preview; apply=true performs the replacement after client-side confirmation. Replaces the full caption as plain text, including text formatting; preserves attachment order, alt text and captions. Read contentEditing from get_scheduled_item_readiness first. Attachment changes, embedded mentions/cards, documents, provider-accepted, in-flight and Article schedules are unsupported. Video requires the Zernio delivery route.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>",
      "expectedRevision": "<expectedRevision>",
      "content": "<content>"
    },
    "name": "amend_scheduled_note_content"
  }
}

Input Schema

Name	Required	Description
`id`	Yes
`apply`	No
`content`	Yes	Full replacement plain text, not a patch.
`expectedRevision`	Yes

Output Schema

Name	Required	Description	Default
`after`	Yes
`before`	Yes
`status`	Yes
`applied`	Yes
`proposed`	Yes
`confirmation`	Yes
`connectedAccount`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedNov 9, 2026

changedOutput schema / properties / after / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accountCanChange": {
-        "type": "boolean"
-      },
-      "checks": {
-        "additionalProperties": false,
-        "properties": {
-          "coverImage": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "emailDelivery": {
-            "enum": [
-              "enabled",
-              "disabled",
-              "unknown",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "paywall": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "remoteReceipt": {
-            "enum": [
-              "confirmed",
-              "partial",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "subscribeButtons": {
-            "type": "integer"
-          },
-          "substackAudience": {
-            "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
-            "enum": [
-              "freewall",
-              "paywall",
-              "paid_subscribers",
-              "everyone",
-              "not_applicable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "coverImage",
-          "subscribeButtons",
-          "paywall",
-          "substackAudience",
-          "emailDelivery",
-          "remoteReceipt"
-        ],
-        "type": "object"
-      },
-      "deliveryNote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "destinations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "accountId": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "personal_profile",
-                "company_page",
-                "publication",
-                "account",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "platform": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "platform",
-            "kind",
-            "label",
-            "accountId"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "type": "string"
-      },
-      "issues": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "itemUrl": {
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "note",
-          "article"
-        ],
-        "type": "string"
-      },
-      "nextAction": {
-        "enum": [
-          "editable_in_place",
-          "requires_safe_recreation",
-          "already_verified",
-          "not_editable"
-        ],
-        "type": "string"
-      },
-      "pendingScheduleChange": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "connectionId": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "requestedAt": {
-                "anyOf": [
-                  {
-                    "format": "date-time",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "requestedScheduledFor": {
-                "format": "date-time",
-                "type": "string"
-              },
-              "requestedTimezone": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "verificationRequired": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "requestedScheduledFor",
-              "requestedTimezone",
-              "requestedAt",
-              "verificationRequired",
-              "connectionId"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "platforms": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "readiness": {
-        "enum": [
-          "ready",
-          "needs_action",
-          "verified",
-          "terminal"
-        ],
-        "type": "string"
-      },
-      "revision": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "scheduledFor": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "schemaVersion": {
-        "const": 1,
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      },
-      "timezone": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "id",
-      "itemUrl",
-      "kind",
-      "revision",
-      "title",
-      "status",
-      "scheduledFor",
-      "timezone",
-      "platforms",
-      "destinations",
-      "checks",
-      "readiness",
-      "nextAction",
-      "issues",
-      "deliveryNote",
-      "accountCanChange",
-      "pendingScheduleChange"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountCanChange": {
+        "type": "boolean"
+      },
+      "checks": {
+        "additionalProperties": false,
+        "properties": {
+          "coverImage": {
+            "description": "The article cover (thumbnail) only. missing does not mean the body has no images; see inlineImages.",
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "emailDelivery": {
+            "enum": [
+              "enabled",
+              "disabled",
+              "unknown",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "inlineImages": {
+            "description": "Images inside the article body, not counting the cover.",
+            "type": "integer"
+          },
+          "paywall": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "placeholderText": {
+            "description": "Bracketed placeholders such as [Image here] still in the text. Each one would be published as written.",
+            "type": "integer"
+          },
+          "remoteReceipt": {
+            "enum": [
+              "confirmed",
+              "partial",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "subscribeButtons": {
+            "type": "integer"
+          },
+          "substackAudience": {
+            "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
+            "enum": [
+              "freewall",
+              "paywall",
+              "paid_subscribers",
+              "everyone",
+              "not_applicable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "coverImage",
+          "subscribeButtons",
+          "paywall",
+          "substackAudience",
+          "emailDelivery",
+          "remoteReceipt"
+        ],
+        "type": "object"
+      },
+      "deliveryNote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "destinations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "accountId": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "personal_profile",
+                "company_page",
+                "publication",
+                "account",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "platform",
+            "kind",
+            "label",
+            "accountId"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "issues": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "itemUrl": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "note",
+          "article"
+        ],
+        "type": "string"
+      },
+      "liveUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "nextAction": {
+        "enum": [
+          "editable_in_place",
+          "requires_safe_recreation",
+          "already_verified",
+          "not_editable"
+        ],
+        "type": "string"
+      },
+      "pendingScheduleChange": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "connectionId": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "requestedAt": {
+                "anyOf": [
+                  {
+                    "format": "date-time",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "requestedScheduledFor": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "requestedTimezone": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "verificationRequired": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "requestedScheduledFor",
+              "requestedTimezone",
+              "requestedAt",
+              "verificationRequired",
+              "connectionId"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "platforms": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "needs_action",
+          "verified",
+          "terminal"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "scheduledFor": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "schemaVersion": {
+        "const": 1,
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      },
+      "timezone": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "writerNextAction": {
+        "enum": [
+          "none",
+          "enter_code",
+          "resync",
+          "open_narrareach"
+        ],
+        "type": "string"
+      },
+      "writerState": {
+        "description": "Where the article is, in the writer's words. Tell the writer it is published only when this is published.",
+        "enum": [
+          "scheduled",
+          "publishing",
+          "waiting_for_you",
+          "in_review",
+          "published",
+          "saved_as_draft",
+          "needs_attention",
+          "cancelled"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "id",
+      "itemUrl",
+      "kind",
+      "revision",
+      "title",
+      "status",
+      "scheduledFor",
+      "timezone",
+      "platforms",
+      "destinations",
+      "checks",
+      "readiness",
+      "nextAction",
+      "issues",
+      "deliveryNote",
+      "accountCanChange",
+      "pendingScheduleChange"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / before / properties / checks / properties / coverImage / description

Added value: +"The article cover (thumbnail) only. missing does not mean the body has no images; see inlineImages."

addedOutput schema / properties / before / properties / checks / properties / inlineImages

Added value: +{
+  "description": "Images inside the article body, not counting the cover.",
+  "type": "integer"
+}

addedOutput schema / properties / before / properties / checks / properties / placeholderText

Added value: +{
+  "description": "Bracketed placeholders such as [Image here] still in the text. Each one would be published as written.",
+  "type": "integer"
+}

addedOutput schema / properties / before / properties / liveUrl

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / before / properties / writerNextAction

Added value: +{
+  "enum": [
+    "none",
+    "enter_code",
+    "resync",
+    "open_narrareach"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / before / properties / writerState

Added value: +{
+  "description": "Where the article is, in the writer's words. Tell the writer it is published only when this is published.",
+  "enum": [
+    "scheduled",
+    "publishing",
+    "waiting_for_you",
+    "in_review",
+    "published",
+    "saved_as_draft",
+    "needs_attention",
+    "cancelled"
+  ],
+  "type": "string"
+}

Changed3 schema fields changedOct 29, 2026

changedOutput schema / properties / after / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accountCanChange": {
-        "type": "boolean"
-      },
-      "checks": {
-        "additionalProperties": false,
-        "properties": {
-          "coverImage": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "emailDelivery": {
-            "enum": [
-              "enabled",
-              "disabled",
-              "unknown",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "paywall": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "remoteReceipt": {
-            "enum": [
-              "confirmed",
-              "partial",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "subscribeButtons": {
-            "type": "integer"
-          },
-          "substackAudience": {
-            "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
-            "enum": [
-              "freewall",
-              "paywall",
-              "paid_subscribers",
-              "everyone",
-              "not_applicable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "coverImage",
-          "subscribeButtons",
-          "paywall",
-          "substackAudience",
-          "emailDelivery",
-          "remoteReceipt"
-        ],
-        "type": "object"
-      },
-      "deliveryNote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "destinations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "accountId": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "personal_profile",
-                "company_page",
-                "publication",
-                "account",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "platform": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "platform",
-            "kind",
-            "label",
-            "accountId"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "type": "string"
-      },
-      "issues": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "itemUrl": {
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "note",
-          "article"
-        ],
-        "type": "string"
-      },
-      "nextAction": {
-        "enum": [
-          "editable_in_place",
-          "requires_safe_recreation",
-          "already_verified",
-          "not_editable"
-        ],
-        "type": "string"
-      },
-      "platforms": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "readiness": {
-        "enum": [
-          "ready",
-          "needs_action",
-          "verified",
-          "terminal"
-        ],
-        "type": "string"
-      },
-      "revision": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "scheduledFor": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "schemaVersion": {
-        "const": 1,
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      },
-      "timezone": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "id",
-      "itemUrl",
-      "kind",
-      "revision",
-      "title",
-      "status",
-      "scheduledFor",
-      "timezone",
-      "platforms",
-      "destinations",
-      "checks",
-      "readiness",
-      "nextAction",
-      "issues",
-      "deliveryNote",
-      "accountCanChange"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountCanChange": {
+        "type": "boolean"
+      },
+      "checks": {
+        "additionalProperties": false,
+        "properties": {
+          "coverImage": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "emailDelivery": {
+            "enum": [
+              "enabled",
+              "disabled",
+              "unknown",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "paywall": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "remoteReceipt": {
+            "enum": [
+              "confirmed",
+              "partial",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "subscribeButtons": {
+            "type": "integer"
+          },
+          "substackAudience": {
+            "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
+            "enum": [
+              "freewall",
+              "paywall",
+              "paid_subscribers",
+              "everyone",
+              "not_applicable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "coverImage",
+          "subscribeButtons",
+          "paywall",
+          "substackAudience",
+          "emailDelivery",
+          "remoteReceipt"
+        ],
+        "type": "object"
+      },
+      "deliveryNote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "destinations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "accountId": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "personal_profile",
+                "company_page",
+                "publication",
+                "account",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "platform",
+            "kind",
+            "label",
+            "accountId"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "issues": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "itemUrl": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "note",
+          "article"
+        ],
+        "type": "string"
+      },
+      "nextAction": {
+        "enum": [
+          "editable_in_place",
+          "requires_safe_recreation",
+          "already_verified",
+          "not_editable"
+        ],
+        "type": "string"
+      },
+      "pendingScheduleChange": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "connectionId": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "requestedAt": {
+                "anyOf": [
+                  {
+                    "format": "date-time",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "requestedScheduledFor": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "requestedTimezone": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "verificationRequired": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "requestedScheduledFor",
+              "requestedTimezone",
+              "requestedAt",
+              "verificationRequired",
+              "connectionId"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "platforms": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "needs_action",
+          "verified",
+          "terminal"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "scheduledFor": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "schemaVersion": {
+        "const": 1,
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      },
+      "timezone": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "id",
+      "itemUrl",
+      "kind",
+      "revision",
+      "title",
+      "status",
+      "scheduledFor",
+      "timezone",
+      "platforms",
+      "destinations",
+      "checks",
+      "readiness",
+      "nextAction",
+      "issues",
+      "deliveryNote",
+      "accountCanChange",
+      "pendingScheduleChange"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / before / properties / pendingScheduleChange

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "connectionId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "requestedAt": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "requestedScheduledFor": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "requestedTimezone": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "verificationRequired": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "requestedScheduledFor",
+        "requestedTimezone",
+        "requestedAt",
+        "verificationRequired",
+        "connectionId"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / before / required

Previous value: -[
-  "schemaVersion",
-  "id",
-  "itemUrl",
-  "kind",
-  "revision",
-  "title",
-  "status",
-  "scheduledFor",
-  "timezone",
-  "platforms",
-  "destinations",
-  "checks",
-  "readiness",
-  "nextAction",
-  "issues",
-  "deliveryNote",
-  "accountCanChange"
-]New value: +[
+  "schemaVersion",
+  "id",
+  "itemUrl",
+  "kind",
+  "revision",
+  "title",
+  "status",
+  "scheduledFor",
+  "timezone",
+  "platforms",
+  "destinations",
+  "checks",
+  "readiness",
+  "nextAction",
+  "issues",
+  "deliveryNote",
+  "accountCanChange",
+  "pendingScheduleChange"
+]

Changed3 schema fields changedOct 27, 2026

addedOutput schema / properties / proposed / properties / attachments
```
Added value: +{
+  "const": "preserved",
+  "type": "string"
+}
```

addedOutput schema / properties / proposed / properties / textFormatting

Added value: +{
+  "const": "plain_text_replacement",
+  "type": "string"
+}

changedOutput schema / properties / proposed / required

Previous value: -[
-  "content"
-]New value: +[
+  "content",
+  "attachments",
+  "textFormatting"
+]

Changed3 schema fields changedOct 23, 2026

changedOutput schema / properties / after / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accountCanChange": {
-        "type": "boolean"
-      },
-      "checks": {
-        "additionalProperties": false,
-        "properties": {
-          "coverImage": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "emailDelivery": {
-            "enum": [
-              "enabled",
-              "disabled",
-              "unknown",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "paywall": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "remoteReceipt": {
-            "enum": [
-              "confirmed",
-              "partial",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "subscribeButtons": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "coverImage",
-          "subscribeButtons",
-          "paywall",
-          "emailDelivery",
-          "remoteReceipt"
-        ],
-        "type": "object"
-      },
-      "deliveryNote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "destinations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "accountId": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "personal_profile",
-                "company_page",
-                "publication",
-                "account",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "platform": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "platform",
-            "kind",
-            "label",
-            "accountId"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "type": "string"
-      },
-      "issues": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "itemUrl": {
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "note",
-          "article"
-        ],
-        "type": "string"
-      },
-      "nextAction": {
-        "enum": [
-          "editable_in_place",
-          "requires_safe_recreation",
-          "already_verified",
-          "not_editable"
-        ],
-        "type": "string"
-      },
-      "platforms": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "readiness": {
-        "enum": [
-          "ready",
-          "needs_action",
-          "verified",
-          "terminal"
-        ],
-        "type": "string"
-      },
-      "revision": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "scheduledFor": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "schemaVersion": {
-        "const": 1,
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      },
-      "timezone": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "id",
-      "itemUrl",
-      "kind",
-      "revision",
-      "title",
-      "status",
-      "scheduledFor",
-      "timezone",
-      "platforms",
-      "destinations",
-      "checks",
-      "readiness",
-      "nextAction",
-      "issues",
-      "deliveryNote",
-      "accountCanChange"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountCanChange": {
+        "type": "boolean"
+      },
+      "checks": {
+        "additionalProperties": false,
+        "properties": {
+          "coverImage": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "emailDelivery": {
+            "enum": [
+              "enabled",
+              "disabled",
+              "unknown",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "paywall": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "remoteReceipt": {
+            "enum": [
+              "confirmed",
+              "partial",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "subscribeButtons": {
+            "type": "integer"
+          },
+          "substackAudience": {
+            "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
+            "enum": [
+              "freewall",
+              "paywall",
+              "paid_subscribers",
+              "everyone",
+              "not_applicable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "coverImage",
+          "subscribeButtons",
+          "paywall",
+          "substackAudience",
+          "emailDelivery",
+          "remoteReceipt"
+        ],
+        "type": "object"
+      },
+      "deliveryNote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "destinations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "accountId": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "personal_profile",
+                "company_page",
+                "publication",
+                "account",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "platform",
+            "kind",
+            "label",
+            "accountId"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "issues": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "itemUrl": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "note",
+          "article"
+        ],
+        "type": "string"
+      },
+      "nextAction": {
+        "enum": [
+          "editable_in_place",
+          "requires_safe_recreation",
+          "already_verified",
+          "not_editable"
+        ],
+        "type": "string"
+      },
+      "platforms": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "needs_action",
+          "verified",
+          "terminal"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "scheduledFor": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "schemaVersion": {
+        "const": 1,
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      },
+      "timezone": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "id",
+      "itemUrl",
+      "kind",
+      "revision",
+      "title",
+      "status",
+      "scheduledFor",
+      "timezone",
+      "platforms",
+      "destinations",
+      "checks",
+      "readiness",
+      "nextAction",
+      "issues",
+      "deliveryNote",
+      "accountCanChange"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / before / properties / checks / properties / substackAudience

Added value: +{
+  "description": "Who can read past the opening on Substack: freewall (free and paid subscribers), paywall (paid subscribers below the wall), paid_subscribers (whole post), or everyone.",
+  "enum": [
+    "freewall",
+    "paywall",
+    "paid_subscribers",
+    "everyone",
+    "not_applicable"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / before / properties / checks / required

Previous value: -[
-  "coverImage",
-  "subscribeButtons",
-  "paywall",
-  "emailDelivery",
-  "remoteReceipt"
-]New value: +[
+  "coverImage",
+  "subscribeButtons",
+  "paywall",
+  "substackAudience",
+  "emailDelivery",
+  "remoteReceipt"
+]

Changed5 schema fields changedOct 12, 2026

changedOutput schema / properties / after / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "checks": {
-        "additionalProperties": false,
-        "properties": {
-          "coverImage": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "emailDelivery": {
-            "enum": [
-              "enabled",
-              "disabled",
-              "unknown",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "paywall": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "remoteReceipt": {
-            "enum": [
-              "confirmed",
-              "partial",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "subscribeButtons": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "coverImage",
-          "subscribeButtons",
-          "paywall",
-          "emailDelivery",
-          "remoteReceipt"
-        ],
-        "type": "object"
-      },
-      "deliveryNote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "destinations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "kind": {
-              "enum": [
-                "personal_profile",
-                "company_page",
-                "publication",
-                "account",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "platform": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "platform",
-            "kind",
-            "label"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "type": "string"
-      },
-      "issues": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "itemUrl": {
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "note",
-          "article"
-        ],
-        "type": "string"
-      },
-      "nextAction": {
-        "enum": [
-          "editable_in_place",
-          "requires_safe_recreation",
-          "already_verified",
-          "not_editable"
-        ],
-        "type": "string"
-      },
-      "platforms": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "readiness": {
-        "enum": [
-          "ready",
-          "needs_action",
-          "verified",
-          "terminal"
-        ],
-        "type": "string"
-      },
-      "revision": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "scheduledFor": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "schemaVersion": {
-        "const": 1,
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      },
-      "timezone": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "id",
-      "itemUrl",
-      "kind",
-      "revision",
-      "title",
-      "status",
-      "scheduledFor",
-      "timezone",
-      "platforms",
-      "destinations",
-      "checks",
-      "readiness",
-      "nextAction",
-      "issues",
-      "deliveryNote"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountCanChange": {
+        "type": "boolean"
+      },
+      "checks": {
+        "additionalProperties": false,
+        "properties": {
+          "coverImage": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "emailDelivery": {
+            "enum": [
+              "enabled",
+              "disabled",
+              "unknown",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "paywall": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "remoteReceipt": {
+            "enum": [
+              "confirmed",
+              "partial",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "subscribeButtons": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "coverImage",
+          "subscribeButtons",
+          "paywall",
+          "emailDelivery",
+          "remoteReceipt"
+        ],
+        "type": "object"
+      },
+      "deliveryNote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "destinations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "accountId": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "personal_profile",
+                "company_page",
+                "publication",
+                "account",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "platform",
+            "kind",
+            "label",
+            "accountId"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "issues": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "itemUrl": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "note",
+          "article"
+        ],
+        "type": "string"
+      },
+      "nextAction": {
+        "enum": [
+          "editable_in_place",
+          "requires_safe_recreation",
+          "already_verified",
+          "not_editable"
+        ],
+        "type": "string"
+      },
+      "platforms": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "needs_action",
+          "verified",
+          "terminal"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "scheduledFor": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "schemaVersion": {
+        "const": 1,
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      },
+      "timezone": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "id",
+      "itemUrl",
+      "kind",
+      "revision",
+      "title",
+      "status",
+      "scheduledFor",
+      "timezone",
+      "platforms",
+      "destinations",
+      "checks",
+      "readiness",
+      "nextAction",
+      "issues",
+      "deliveryNote",
+      "accountCanChange"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / before / properties / accountCanChange
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / before / properties / destinations / items / properties / accountId

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / before / properties / destinations / items / required

Previous value: -[
-  "platform",
-  "kind",
-  "label"
-]New value: +[
+  "platform",
+  "kind",
+  "label",
+  "accountId"
+]

changedOutput schema / properties / before / required

Previous value: -[
-  "schemaVersion",
-  "id",
-  "itemUrl",
-  "kind",
-  "revision",
-  "title",
-  "status",
-  "scheduledFor",
-  "timezone",
-  "platforms",
-  "destinations",
-  "checks",
-  "readiness",
-  "nextAction",
-  "issues",
-  "deliveryNote"
-]New value: +[
+  "schemaVersion",
+  "id",
+  "itemUrl",
+  "kind",
+  "revision",
+  "title",
+  "status",
+  "scheduledFor",
+  "timezone",
+  "platforms",
+  "destinations",
+  "checks",
+  "readiness",
+  "nextAction",
+  "issues",
+  "deliveryNote",
+  "accountCanChange"
+]

Changed3 schema fields changedOct 8, 2026

changedOutput schema / properties / after / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "checks": {
-        "additionalProperties": false,
-        "properties": {
-          "coverImage": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "emailDelivery": {
-            "enum": [
-              "enabled",
-              "disabled",
-              "unknown",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "paywall": {
-            "enum": [
-              "present",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "remoteReceipt": {
-            "enum": [
-              "confirmed",
-              "partial",
-              "missing",
-              "not_applicable"
-            ],
-            "type": "string"
-          },
-          "subscribeButtons": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "coverImage",
-          "subscribeButtons",
-          "paywall",
-          "emailDelivery",
-          "remoteReceipt"
-        ],
-        "type": "object"
-      },
-      "destinations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "kind": {
-              "enum": [
-                "personal_profile",
-                "company_page",
-                "publication",
-                "account",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "platform": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "platform",
-            "kind",
-            "label"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "type": "string"
-      },
-      "issues": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "itemUrl": {
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "note",
-          "article"
-        ],
-        "type": "string"
-      },
-      "nextAction": {
-        "enum": [
-          "editable_in_place",
-          "requires_safe_recreation",
-          "already_verified",
-          "not_editable"
-        ],
-        "type": "string"
-      },
-      "platforms": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "readiness": {
-        "enum": [
-          "ready",
-          "needs_action",
-          "verified",
-          "terminal"
-        ],
-        "type": "string"
-      },
-      "revision": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "scheduledFor": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "schemaVersion": {
-        "const": 1,
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      },
-      "timezone": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "id",
-      "itemUrl",
-      "kind",
-      "revision",
-      "title",
-      "status",
-      "scheduledFor",
-      "timezone",
-      "platforms",
-      "destinations",
-      "checks",
-      "readiness",
-      "nextAction",
-      "issues"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "checks": {
+        "additionalProperties": false,
+        "properties": {
+          "coverImage": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "emailDelivery": {
+            "enum": [
+              "enabled",
+              "disabled",
+              "unknown",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "paywall": {
+            "enum": [
+              "present",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "remoteReceipt": {
+            "enum": [
+              "confirmed",
+              "partial",
+              "missing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "subscribeButtons": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "coverImage",
+          "subscribeButtons",
+          "paywall",
+          "emailDelivery",
+          "remoteReceipt"
+        ],
+        "type": "object"
+      },
+      "deliveryNote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "destinations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "enum": [
+                "personal_profile",
+                "company_page",
+                "publication",
+                "account",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "platform",
+            "kind",
+            "label"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "issues": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "itemUrl": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "note",
+          "article"
+        ],
+        "type": "string"
+      },
+      "nextAction": {
+        "enum": [
+          "editable_in_place",
+          "requires_safe_recreation",
+          "already_verified",
+          "not_editable"
+        ],
+        "type": "string"
+      },
+      "platforms": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "needs_action",
+          "verified",
+          "terminal"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "scheduledFor": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "schemaVersion": {
+        "const": 1,
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      },
+      "timezone": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "id",
+      "itemUrl",
+      "kind",
+      "revision",
+      "title",
+      "status",
+      "scheduledFor",
+      "timezone",
+      "platforms",
+      "destinations",
+      "checks",
+      "readiness",
+      "nextAction",
+      "issues",
+      "deliveryNote"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / before / properties / deliveryNote

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / before / required

Previous value: -[
-  "schemaVersion",
-  "id",
-  "itemUrl",
-  "kind",
-  "revision",
-  "title",
-  "status",
-  "scheduledFor",
-  "timezone",
-  "platforms",
-  "destinations",
-  "checks",
-  "readiness",
-  "nextAction",
-  "issues"
-]New value: +[
+  "schemaVersion",
+  "id",
+  "itemUrl",
+  "kind",
+  "revision",
+  "title",
+  "status",
+  "scheduledFor",
+  "timezone",
+  "platforms",
+  "destinations",
+  "checks",
+  "readiness",
+  "nextAction",
+  "issues",
+  "deliveryNote"
+]

First observedOct 1, 2026

TDQS

A4.1/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, idempotentHint=true and readOnlyHint=false, so the safety profile is largely covered. The description still adds real value: it explains that the full caption is replaced as plain text including formatting, that images, supported videos, attachment order, alt text and captions survive, and that the queued delivery snapshot rather than a shared draft is affected. That is solid context beyond the annotations, though it does not say what happens to the previous revision or how a failed apply behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical framing, what it does and the preview-versus-apply distinction, is front-loaded, and every later clause carries a distinct constraint. The middle is dense with comma-separated caveats that take effort to parse, but no sentence is filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive mutation tool with an output schema (so return values need not be described), the definition covers the prerequisite call, the preview path, the mutation path, preservation guarantees, and the full unsupported-case list. An agent has enough to decide whether to call it and how to sequence it safely.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 25%, with just 'content' documented, so the description must carry the rest and largely does: id is the scheduled Note id, expectedRevision must be the exact current revision, apply defaults to false for a non-mutating preview, and content is a full plain-text replacement. It does not spell out the revision-mismatch failure mode or the date-time format for expectedRevision, which the schema supplies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a precise verb and resource: preview or replace the text of an untouched queued LinkedIn post, keyed by scheduled Note id and exact revision. It also scopes the operation ('Changes the queued delivery snapshot, not a shared draft'), which separates it from draft-editing tools. It stops short of naming the broader sibling amend_scheduled_item to clarify why this text-only variant exists.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit prerequisite (read contentEditing from get_scheduled_item_readiness first), an explicit default behavior (apply=false previews without mutation), and the condition for mutation (apply=true after client-side confirmation). It also enumerates when the tool is not usable: attachment changes, embedded mentions/cards, documents, provider-accepted, in-flight, Article schedules, and video outside the Zernio delivery route.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Narrareach tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?