socifyr edit, retry and publish
Three commands manage a post after it exists: edit changes a draft or scheduled post, retry re-queues failed channels, and publish sends a saved draft.
socifyr edit
Edit a draft or a scheduled post: its text, schedule, accounts, media or format. Published and in-flight posts cannot be edited.
socifyr edit <id> [--text <text>] [--title <title>] [--to <slugs>] [--at <iso>] [--media-id <refs>] [--format <fmt>] [--json]| Flag | Description |
|---|---|
--text <text> | New caption or body text |
--title <title> | New title |
-t, --to <connections> | Comma-separated slugs. This is the full set of accounts and replaces the current ones |
--at <iso> | New schedule time. For a scheduled post it must be in the future |
--media-id <refs> | Comma-separated media library IDs. Replaces the current media |
--format <fmt> | Content format override, for example short_video or photo_carousel |
--json | Print the API response as JSON |
With no edit flag the command prints Nothing to update. Pass --text, --title, --to, --at, --media-id, or --format. and exits with 1.
How do I add or remove an account on a scheduled post?
--to replaces the whole list. To add LinkedIn to a post that targets Instagram and X, list all three:
socifyr edit 6a05032a84584482ace13d5f --to instagram-mybrand,x-mybrand,linkedin-mybrand
# ✓ Post updated
# ID: 6a05032a84584482ace13d5f
# Connections: instagram-mybrand, x-mybrand, linkedin-mybrand
# Check status: socifyr status 6a05032a84584482ace13d5fHow do I reschedule a post from the CLI?
socifyr edit 6a05032a84584482ace13d5f --at 2026-12-01T09:00:00Z --text "Updated caption"The queued job moves to the new time. The CLI has no command to list posts, so take the ID from the output of the command that created the post, from the dashboard, or from the MCP list_posts tool.
socifyr retry
Re-queue the failed channels of a post. Channels that already published are skipped.
socifyr retry <id> [--wait] [--json]| Flag | Description |
|---|---|
-w, --wait | Wait for a final state and print per-platform results |
--json | Print the response as JSON |
socifyr retry 6a05032a84584482ace13d5f
# ✓ Retry queued
# ID: 6a05032a84584482ace13d5f
# Check status: socifyr status 6a05032a84584482ace13d5fThe post must be failed or partial_failure; otherwise the API answers 409 with Cannot retry an upload with status "<status>". With --json and no --wait, the response includes retriedChannels, the number of channels re-queued.
How do I find which channels failed before retrying?
socifyr status <id> --json | jq '.channels[] | select(.result.status == "failed")'If the error says the token expired or the account must be reconnected, fix the account first with socifyr connections reconnect, then retry.
socifyr publish
Publish a saved draft immediately.
socifyr publish <draft-id> [--wait] [--json]| Flag | Description |
|---|---|
-w, --wait | Wait for a final state and print per-platform results |
--json | Print the response as JSON |
DRAFT=$(socifyr post "Polish this" --media banner.jpg --to instagram-mybrand --draft --json | jq -r '.id')
socifyr publish "$DRAFT" --wait
# Post 6a05032a84584482ace13d5f
# Status: completed
#
# ✓ instagram → https://instagram.com/p/...Without --wait the CLI prints ✓ Draft published and the ID. A published draft then follows the normal post lifecycle.
API keys that require approval
A key with requireApproval cannot publish drafts directly. The API answers 403 with This API key requires approval and cannot publish drafts directly — submit the post for approval and a teammate will review it. The CLI has no command to submit a draft for approval; use the dashboard, the REST endpoint, or the SDK. See feature parity.