Post tools

Create, read, edit, and delete drafts.

list_posts

Lists posts in the studio, newest first, each with its attached assets and studio url.

status · enum

Optional filter: draft, scheduled, queued, posted, or failed. Omit for everything.

Prompt

Show me my scheduled posts.

Returns an array of post objects.

get_post

Fetches one post by id.

id · string · required

Post id.

Returns the post, or not_found if the id belongs to another studio or does not exist.

create_draft

Creates a draft.

content · string · required

Body text. Up to 10,000 characters — per-platform limits are checked at publish time, not here.

targetPlatforms · string[]

Platforms to target. Omit, or pass an empty array, to target every supported platform.

Input

{
  "content": "We just shipped scheduling in Studio.",
  "targetPlatforms": ["linkedin"]
}

Returns the new draft including its url. Give that link to the user rather than the raw id.

update_draft

Patches a draft in place. Only the fields you pass change.

id · string · required

Post id.

content · string

Replacement body text. Allowed while the post is draft or scheduled; on a scheduled post the new text must still fit the platform it is aimed at.

targetPlatforms · string[]

Replacement target list. Draft only — unschedule first, or you get cannot_edit_scheduled_post.

delete_draft

Deletes a post permanently.

id · string · required

Post id.

Returns { "deleted": "<id>" }.

A post mid-dispatch (queued) can’t be deleted — you get dispatch_in_progress. Wait for it to settle to posted or failed. Deleting a posted post removes Studio’s record only; the post stays live on the platform.