socifyr status
socifyr status <id> shows whether a post published and what happened on each platform.
bash
socifyr status <id> [--wait] [--json]<id> is the ID printed by socifyr post, socifyr publish or socifyr retry. The API's status endpoint also accepts the requestId returned when the post was created.
What flags does socifyr status take?
| Flag | Description | Default |
|---|---|---|
-w, --wait | Poll every 3 seconds until the post is completed, failed or partial_failure, with a 5 minute timeout | off |
--json | Print the full status response as JSON | off |
How do I check the status of a post?
bash
socifyr status 6a05032a84584482ace13d5fPost 6a05032a84584482ace13d5f
Status: partial_failure
✓ linkedin → https://linkedin.com/feed/update/...
✗ x
rate limit exceededEach line is one platform channel. A check mark means that channel published and shows the post URL. A cross shows the platform's error message. A dot means the channel has not finished.
What do the post statuses mean?
| Status | Meaning |
|---|---|
draft | Saved, not submitted |
pending_approval | Waiting for a teammate to approve (approval-required API keys and submitted drafts) |
pending | Accepted and about to be processed; scheduled posts wait here or in queued until their time |
queued | Dispatched, waiting for the queue to pick it up |
processing | Media is being validated or transcoded |
publishing | Fanning out to each platform |
completed | Published on every channel |
partial_failure | Some channels published, some failed. Retry them |
failed | No channel published |
Only completed, partial_failure and failed are final. The full flow is in post lifecycle.
How do I get the status as JSON?
bash
socifyr status 6a05032a84584482ace13d5f --jsonjson
{
"requestId": "9f2c7a1e-3d44-4b2a-8e1f-0a5c2d7e9f10",
"uploadId": "6a05032a84584482ace13d5f",
"status": "partial_failure",
"type": "text",
"channels": [
{
"platform": "linkedin",
"connectionId": "6a0502f184584482ace13d10",
"result": { "status": "success", "postUrl": "https://linkedin.com/feed/update/..." }
},
{
"platform": "x",
"connectionId": "6a0502f784584482ace13d11",
"result": { "status": "failed", "error": "rate limit exceeded" }
}
],
"createdAt": "2026-11-13T09:03:06.267Z"
}Channels can also carry targetId, targetName, postId, publishedAt and engagement.
How do I wait for a post to finish in a script?
bash
ID=$(socifyr post "Test" --to linkedin-myhandle --json | jq -r '.id')
STATUS=$(socifyr status "$ID" --wait --json | jq -r '.status')
if [ "$STATUS" != "completed" ]; then
echo "Publish did not fully succeed: $STATUS"
socifyr retry "$ID"
fisocifyr status exits with 0 for any final state. It exits with 1 on an API error or when the 5 minute wait runs out.