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)
| Name | Type | Description |
|---|---|---|
user | String | Profile username. |
posts | Array | 1 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. |
langs | Array or String | Up to 3 language codes, e.g. "en,es". |
reply_settings | String | Who can reply once published: same values as bluesky_threadgate (nobody, mention, following, followers, list:<at://...>). |
quote_settings | String | disable_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);PATCHandDELETEof a wrongdraft_idchange 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; waitretry_afterseconds). 503 —bluesky_edge_rate_limited,bluesky_read_capacity(Bluesky is busy for Upload-Post; retry afterretry_after),bluesky_login_unavailable(signing in to Bluesky failed for a temporary reason; retry in a minute, no need to reconnect).