Skip to main content

List posts

Without dates, the CLI requests the previous 30 days through the next 30 days. Results include root posts, publication state, integration data, provider release IDs, and URLs.

Create a post

Create post.json:
Then run:
You can also use --data '<json>' or --stdin. Multiple items in value create thread segments for platforms that support threads.

Change status and settings

Moving a post to draft terminates its active publishing workflow. Moving it to schedule queues it for its stored publication date. Merge provider-specific settings without replacing unrelated keys:
Only unpublished DRAFT or QUEUE posts can be updated. Pass the root post ID, not a thread segment ID.

Repair missing release IDs

Some providers publish successfully without immediately returning a usable post ID.
After connecting the correct provider content, post analytics can use the release ID.

Delete a post

Deleting the root post also deletes all of its thread segments. The CLI does not ask for confirmation so scripts remain non-interactive; validate the ID before invoking destructive commands.
Last modified on August 26, 2026