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?
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.socifyr post "Caption to polish later" --media banner.jpg --to instagram-mybrand --draftconst draft = await socifyr.uploads.photos({
connections: ['instagram-mybrand'],
medias: ['6a04f715d3d7d93575e65d13'],
text: 'Caption to polish later',
saveDraft: true,
})
console.log(draft.id) // normalized from draftId# 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"])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
}'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:
{ "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.
socifyr edit 6a05032a84584482ace13d5f --text "Final caption" --to instagram-mybrand,x-myhandleawait socifyr.uploads.update('6a05032a84584482ace13d5f', {
text: 'Final caption',
connections: ['instagram-mybrand', 'x-myhandle'],
platformOptions: { 'instagram-mybrand': { text: 'Instagram-only caption' } },
})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"]}'{
"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?
socifyr publish 6a05032a84584482ace13d5f --waitawait socifyr.uploads.publishDraft('6a05032a84584482ace13d5f')client.uploads.publish_draft("6a05032a84584482ace13d5f")curl -X POST https://api.socifyr.com/api/content/6a05032a84584482ace13d5f/publish \
-H "Authorization: Bearer $SOCIFYR_API_KEY"{ "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?
| Error | Status | Fix |
|---|---|---|
Draft must have content type and at least one channel selected | 400 | Add connections with update_post or socifyr edit --to. |
Draft must have content (text or media) before publishing | 400 | Add text or media. |
Draft is already being published | 409 | Wait. Check status. |
This API key requires approval and cannot publish drafts directly ... | 403 | Use submit-for-approval. See approvals. |
This API key has guardrails and can only modify posts it created itself | 403 | Use 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.