Skip to content

How to save, edit and publish a draft ​

Add saveDraft: true to a content request and Socifyr stores the post with status draft instead of publishing it. Edit it with PATCH /api/content/:id, then publish it with POST /api/content/:id/publish. Drafts do not count against your upload or X post allowance until they publish.

Drafts are also how human review works: a draft can be submitted for approval. See Approvals and guardrails.

How do I save a draft? ​

text
1. Sidebar > New Post. Build the post as usual.
2. Click Save Draft instead of Publish. It becomes Update Draft once saved.
3. Find it later under Sidebar > Content with a Draft badge. From there you can
   Publish, Edit or delete it.
bash
socifyr post "Caption to polish later" --media banner.jpg --to instagram-mybrand --draft
typescript
const draft = await socifyr.uploads.photos({
  connections: ['instagram-mybrand'],
  medias: ['6a04f715d3d7d93575e65d13'],
  text: 'Caption to polish later',
  saveDraft: true,
})
console.log(draft.id) // normalized from draftId
python
# Only uploads.text() accepts save_draft in the Python SDK.
res = client.uploads.text(
    connections=["linkedin-myhandle"],
    text="Caption to polish later",
    save_draft=True,
)
print(res["draftId"])
bash
curl -X POST https://api.socifyr.com/api/content/text \
  -H "Authorization: Bearer $SOCIFYR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connections": ["linkedin-myhandle"],
    "text": "Caption to polish later",
    "saveDraft": true
  }'
text
The MCP server cannot create a draft: post_text, post_image and post_video
always publish or schedule. Use list_posts, update_post and publish_draft on
drafts created elsewhere. If your API key requires approval, posts the agent
creates are held in pending_approval, which acts like a draft for review.

The response for a draft contains draftId:

json
{ "success": true, "data": { "success": true, "draftId": "6a05032a84584482ace13d5f" } }

How do I edit a draft? ​

Send only the fields you want to change. Note that update uses mediaIds, while create uses medias. connections is a full replacement of the target accounts, not a delta.

bash
socifyr edit 6a05032a84584482ace13d5f --text "Final caption" --to instagram-mybrand,x-myhandle
typescript
await socifyr.uploads.update('6a05032a84584482ace13d5f', {
  text: 'Final caption',
  connections: ['instagram-mybrand', 'x-myhandle'],
  platformOptions: { 'instagram-mybrand': { text: 'Instagram-only caption' } },
})
bash
curl -X PATCH https://api.socifyr.com/api/content/6a05032a84584482ace13d5f \
  -H "Authorization: Bearer $SOCIFYR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Final caption", "connections": ["instagram-mybrand", "x-myhandle"]}'
json
{
  "tool": "update_post",
  "arguments": {
    "postId": "6a05032a84584482ace13d5f",
    "text": "Final caption",
    "connections": ["instagram-mybrand", "x-myhandle"]
  }
}

The Python SDK has no update method. Editable fields: type, connections, title, description, text, firstComment, mediaIds, scheduledAt, timezone, platformOptions, contentFormat.

How do I publish a draft? ​

bash
socifyr publish 6a05032a84584482ace13d5f --wait
typescript
await socifyr.uploads.publishDraft('6a05032a84584482ace13d5f')
python
client.uploads.publish_draft("6a05032a84584482ace13d5f")
bash
curl -X POST https://api.socifyr.com/api/content/6a05032a84584482ace13d5f/publish \
  -H "Authorization: Bearer $SOCIFYR_API_KEY"
json
{ "tool": "publish_draft", "arguments": { "postId": "6a05032a84584482ace13d5f" } }

Prompt for your agent: "List my drafts and publish the one about the launch." The agent calls list_posts with status: draft, then publish_draft.

Publishing returns an acknowledgement with a requestId. The post then moves pending, processing, publishing, and ends at completed, partial_failure or failed. If the draft has a future scheduledAt, publishing queues it for that time instead of posting now.

What errors can I get, and how do I fix them? ​

ErrorStatusFix
Draft must have content type and at least one channel selected400Add connections with update_post or socifyr edit --to.
Draft must have content (text or media) before publishing400Add text or media.
Draft is already being published409Wait. Check status.
This API key requires approval and cannot publish drafts directly ...403Use submit-for-approval. See approvals.
This API key has guardrails and can only modify posts it created itself403Use a dashboard session or an unrestricted key for posts made by others.

How do I delete a draft? ​

DELETE /api/content/:id, or socifyr.uploads.cancel(id) in the TypeScript SDK. The dashboard has a delete action on the post. The CLI, Python SDK and MCP have no delete-post command.

FAQ ​

Can I convert a draft into a scheduled post? ​

Set scheduledAt with an update, then publish it. The job waits until that time.

Do drafts use my monthly post quota? ​

No. The upload counter and X allowance are charged when the draft publishes.

Next steps ​