HyperContent

Whoami

Show what this connection can act on and what it is allowed to do. Call this first when a permission question comes up — it answers 'can I?' without making a call that fails — and whenever a tool says a workspace is required: a connection made to your account may cover several newsrooms, and this lists them with the ids to pass as `workspace`.

List Posts

List posts in the workspace, newest first. Use `status` to narrow to drafts or published posts. Returns a `nextCursor` when more exist — pass it back as `cursor` to continue, and stop when it comes back null.

Get Post

Read one post in full: its content, variants, and its destinations with their ids and per-destination status. `destinations[].id` is what cancel_scheduled_destination takes — this is where to find it when you no longer have the operation id from publish_post.

List Accounts

List the social accounts this workspace can publish to. `id` is stable — use it when referring to an account in other tools or in analytics.

List Articles

Browse articles available to write posts from, newest first. This is the source material — start here when asked to create a post about something. Pass `search` to filter by title.

Get Article

Read one article in full, including its body text. Read the article before writing copy from it rather than working from the title alone.

Create Draft

Create a draft post. `content` is the shared copy; `destinations` is where it publishes. Give a destination its own `content` to tailor the copy for that account only — everything you leave out there falls back to the shared copy. Nothing publishes until you call publish_post. Get account ids from list_accounts and post types from describe_capabilities. Check each returned destination's `content_warning`: non-null means that destination's text is over the platform's limit and publish_post will r

Update Draft

Edit a draft's shared copy or its destinations. Content is a merge: fields you omit keep their value, and null clears one. Destinations REPLACE — the list you send becomes the post's destinations, so omitting one removes it, and omitting the field entirely leaves them alone. Read the draft first with get_draft, change what you need, and send it back. Only unpublished drafts can be edited. Check each returned destination's `content_warning`: non-null means that destination's text is over the plat

Get Draft

Read a draft in the same shape create_draft and update_draft accept — read it, change one field, write it back. Use this before editing rather than guessing the current content.

Delete Draft

Permanently delete a draft and everything attached to it. Only works on drafts that were never published — a post with live destinations is refused, because deleting the record here would not remove anything from the platform and would just lose your record of what is out there. There is no undo.

Check Publish

Check whether a post WOULD publish, and get the full plan of what would go out. Publishes nothing. Returns every destination with the exact copy that will appear on it, plus a `confirmation` value that `publish_post` requires. SHOW THE RETURNED PLAN TO THE USER IN FULL AND GET THEIR EXPLICIT APPROVAL before publishing — this posts publicly to a real newsroom's accounts. Pass `scheduledFor` here too if you intend to schedule, so the plan they approve is the one you carry out.

Publish Post

Publish a draft to its destinations, or schedule it with `scheduledFor` (ISO 8601). THIS POSTS PUBLICLY to a real newsroom's accounts and cannot be undone from here. Requires `confirmation` from check_publish, which you must have shown to the user and had them approve. Returns an operation id; publishing is asynchronous, so call `check_publish_status` to find out whether each destination succeeded.

Check Publish Status

Check a publish started by `publish_post`. `done` means every destination has finished — it does NOT mean all succeeded, so read each destination's status: a publish can partly succeed. A succeeded destination always carries `remote_id`, the platform's own id for the post; `remote_url` may be null for a few minutes after publishing and fills in once the link is resolved, so report the post as published without waiting for it.

Cancel Scheduled Destination

Cancel one scheduled destination before it publishes. Takes a destination id from `check_publish_status`, not a post id — a post scheduled to four accounts is four separate destinations.

Describe Capabilities

What each platform accepts: post types, caption limits, page counts, and whether a type can currently be published at all. Consult this before composing content for a platform rather than assuming its limits.