Manage posts

Manage posts from the DunSocial CLI: list them with filters, fetch one by id, reschedule a scheduled post, cancel it, or delete it, straight from the terminal.

List posts

dun posts list
dun posts list --status scheduled --limit 20
dun posts list --account ACCOUNT_ID --json

--status examples: scheduled, published, failed, draft, cancelled.

JSON list items include mediaUrls (media asset ids), the same field as dun posts get.

Get one post

dun posts get POST_ID

Reschedule

dun posts reschedule POST_ID --in 3h
dun posts reschedule POST_ID --at 2026-08-01T15:00:00Z --text "Updated copy"

If you omit --text, the CLI keeps the existing content, media, and metadata.

Cancel a scheduled post

dun posts cancel POST_ID

Delete

Destructive. Requires --yes (or CI=1):

dun posts delete POST_ID --yes

X monthly cap

dun posts x-cap

Useful before a large batch of X posts.