Skip to main content

Bluesky: drafts

Bluesky keeps drafts in the account's private storage, and the official Bluesky app shows them in its drafts list. Bluesky never publishes a draft by itself: to publish later, use scheduling.

GET    /api/uploadposts/bluesky/drafts?user=my-profile[&limit=50][&cursor=]
POST /api/uploadposts/bluesky/drafts
PATCH /api/uploadposts/bluesky/drafts/{draft_id}
DELETE /api/uploadposts/bluesky/drafts/{draft_id}

Body (POST and PATCH)​

NameTypeDescription
userStringProfile username.
postsArray1 to 100 posts (a thread): [{"text": "...", "link_url": "https://...", "quote_uri": "at://...", "labels": ["nudity"]}]. text up to 1,000 characters. Shortcut: send text alone for a one-post draft.
langsArray or StringUp to 3 language codes, e.g. "en,es".
reply_settingsStringWho can reply once published: same values as bluesky_threadgate (nobody, mention, following, followers, list:<at://...>).
quote_settingsStringdisable_quotes to stop quotes once published.

Images and video are not accepted: Bluesky stores draft media as files on the device that made the draft, so a draft made through an API would reach the app without them (400 bluesky_draft_media_unsupported).

PATCH changes the draft's posts, and langs, reply_settings and quote_settings when you send them. Images and videos added to the draft in the Bluesky app are kept (if you send fewer posts than the draft has and a removed post has media, you get 400 bluesky_draft_media_would_be_lost). A draft that no longer exists answers 404. Sending the same POST again within 10 minutes returns the draft created the first time. DELETE needs "confirm": true.

curl -X POST https://api.upload-post.com/api/uploadposts/bluesky/drafts \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"user": "my-profile",
"posts": [{"text": "Launch day is coming", "link_url": "https://example.com/launch"}],
"langs": "en",
"reply_settings": "following"
}'
{"success": true, "platform": "bluesky", "action": "create_draft", "draft_id": "3lbqxyzabc22k", "changed": true}

GET answers drafts as Bluesky returns them (id, draft, createdAt, updatedAt) and a cursor.

Error Responses​

  • 400 — bluesky_draft_media_would_be_lost, invalid_posts, bluesky_text_too_long, invalid_langs, invalid_labels, invalid_url, bluesky_draft_media_unsupported, invalid_draft_id, confirmation_required, bluesky_rejected.
  • 401 — bluesky_reauth_required. 404 — bluesky_not_found: the draft does not exist (or was already deleted); PATCH and DELETE of a wrong draft_id change nothing.
  • 409 — bluesky_draft_limit_reached: the account has as many drafts as Bluesky allows; delete some.
  • 429 — bluesky_rate_limited, bluesky_read_rate_limited (too many Bluesky requests for this Upload-Post account right now; wait retry_after seconds). 503 — bluesky_edge_rate_limited, bluesky_read_capacity (Bluesky is busy for Upload-Post; retry after retry_after), bluesky_login_unavailable (signing in to Bluesky failed for a temporary reason; retry in a minute, no need to reconnect).