Skip to content

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? ​

FlagDescriptionDefault
-w, --waitPoll every 3 seconds until the post is completed, failed or partial_failure, with a 5 minute timeoutoff
--jsonPrint the full status response as JSONoff

How do I check the status of a post? ​

bash
socifyr status 6a05032a84584482ace13d5f
Post 6a05032a84584482ace13d5f
Status: partial_failure

  ✓  linkedin → https://linkedin.com/feed/update/...
  ✗  x
      rate limit exceeded

Each 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? ​

StatusMeaning
draftSaved, not submitted
pending_approvalWaiting for a teammate to approve (approval-required API keys and submitted drafts)
pendingAccepted and about to be processed; scheduled posts wait here or in queued until their time
queuedDispatched, waiting for the queue to pick it up
processingMedia is being validated or transcoded
publishingFanning out to each platform
completedPublished on every channel
partial_failureSome channels published, some failed. Retry them
failedNo 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 --json
json
{
  "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"
fi

socifyr status exits with 0 for any final state. It exits with 1 on an API error or when the 5 minute wait runs out.

Next steps ​