Skip to main content

Bluesky: post and reply actions

Act on a Bluesky post that is already live, from the Bluesky account connected to a profile. These use the same endpoints as the other networks with "platform": "bluesky":

EndpointActions
POST /api/uploadposts/posts/actionlike, unlike, repost, unrepost, bookmark, unbookmark, pin, unpin, reply_settings, quote_settings, detach_quote, reattach_quote
POST /api/uploadposts/posts/repostrepost (same as posts/action with "action": "repost")
POST /api/uploadposts/posts/savebookmark (a private Bluesky bookmark)
POST /api/uploadposts/comments/actionhide, unhide, like, unlike on a reply

Every action has its inverse, and sending an action that is already in place (liking a post you already liked) changes nothing and answers "changed": false. Repeating the same like, repost or follow within two minutes (a retry after a timeout, a double click) returns the first answer with "replayed": true instead of writing again; while the first one is still running you get 409 bluesky_action_in_progress.

Like and repost are not generally available yet: until they are, they answer 503 bluesky_feature_disabled. Bookmark, pin, reply and quote settings and hiding replies are available.

Headers​

NameValueDescription
AuthorizationApikey your-api-key-hereYour API key for authentication
Content-Typeapplication/jsonRequest body format

Post actions​

Body Parameters (JSON)​

NameTypeRequiredDescription
platformStringYesbluesky
userStringYesProfile username.
actionStringYesOne of the actions below.
post_idStringYes (not for unpin)The post: its at:// URI (the post_id returned when you published it) or its https://bsky.app/profile/<handle>/post/<id> link.
reply_settingsString or arrayFor reply_settingsSame values as bluesky_threadgate on upload: everyone, nobody, or a comma-separated set of mention, following, followers, list:<at:// list URI>.
quote_settingsStringFor quote_settingsdisable_quotes (nobody can quote the post) or everyone.
quote_uriStringFor detach_quote / reattach_quoteThe post that quotes yours (at:// URI or bsky.app link).
ActionWhat it does
like / unlikeLike the post, or remove your like.
repost / unrepostRepost the post, or undo your repost.
bookmark / unbookmarkSave the post to the account's private bookmarks, or remove it.
pin / unpinPin one of the account's own posts to the top of its profile, or unpin it. The rest of the profile (avatar, banner, bio) is kept as it is.
reply_settingsChange who can reply to one of the account's own posts after publishing. Only the first post of a thread can carry reply settings. everyone removes the restriction.
quote_settingsAllow or stop quotes of one of the account's own posts.
detach_quote / reattach_quoteRemove your post from someone else's quote of it (Bluesky shows it as "removed by the author"), or undo that. Up to 50 detached quotes per post.

Example Requests​

curl -X POST https://api.upload-post.com/api/uploadposts/posts/action \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"platform": "bluesky",
"user": "my-profile",
"action": "like",
"post_id": "https://bsky.app/profile/someone.bsky.social/post/3lbq2xyzabc2k"
}'
curl -X POST https://api.upload-post.com/api/uploadposts/posts/action \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"platform": "bluesky",
"user": "my-profile",
"action": "reply_settings",
"post_id": "at://did:plc:abc123/app.bsky.feed.post/3lbq2xyzabc2k",
"reply_settings": "following,mention"
}'

Successful Response (200 OK)​

{
"success": true,
"platform": "bluesky",
"action": "like",
"post_id": "at://did:plc:xyz789/app.bsky.feed.post/3lbq2xyzabc2k",
"record_uri": "at://did:plc:abc123/app.bsky.feed.like/3lbq3aaaabbb2",
"changed": true
}

record_uri is the Bluesky record that was written (the like, the repost, the reply settings...). reply_settings and quote_settings echo the value now in place.

Reply actions​

POST /api/uploadposts/comments/action with "platform": "bluesky".

NameTypeRequiredDescription
platformStringYesbluesky
userStringYesProfile username.
comment_idStringYesThe reply: at:// URI or bsky.app link.
actionStringYeshide, unhide, like, unlike.
post_idStringNoThe first post of the thread. Optional; when sent it must match the reply's thread.

hide works on replies in threads the account started: Bluesky stores hidden replies (up to 300 per thread) with the thread's reply settings. Hiding a reply never restricts who can reply.

curl -X POST https://api.upload-post.com/api/uploadposts/comments/action \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"platform": "bluesky",
"user": "my-profile",
"comment_id": "at://did:plc:xyz789/app.bsky.feed.post/3lbq5reply22",
"action": "hide"
}'
{
"success": true,
"platform": "bluesky",
"action": "hide",
"post_id": "at://did:plc:abc123/app.bsky.feed.post/3lbq2xyzabc2k",
"comment_id": "at://did:plc:xyz789/app.bsky.feed.post/3lbq5reply22",
"record_uri": "at://did:plc:abc123/app.bsky.feed.threadgate/3lbq2xyzabc2k",
"changed": true
}

Daily limit on likes, reposts and follows​

Bluesky's Developer Guidelines do not allow automated or bulk interactions that notify other people (likes, reposts, follows). Upload-Post makes up to 200 likes, reposts, follows and list additions per Bluesky account per UTC day (one shared counter, including likes on replies, follows and adding accounts to lists or starter packs). There is also a daily limit per Upload-Post account (all its Bluesky accounts together) and one for Upload-Post as a whole. Undoing (unlike, unrepost, unfollow), bookmarks and reply settings do not count. A like or repost that Bluesky refuses is not counted.

When a limit is reached you get 429 with error_code: "bluesky_daily_interaction_limit", limit, limit_scope (account, user or global), retry_after (seconds) and resets_at (the next 00:00 UTC), and a Retry-After header.

Error Responses​

All errors carry success: false, an error message and, where useful, an error_code.

  • 400 — unsupported_action, missing_post_id, invalid_post_id, invalid_reply_settings, invalid_quote_settings, missing_quote_uri, bluesky_not_root_post (reply settings on a reply), bluesky_not_a_reply, bluesky_wrong_thread, bluesky_hidden_replies_full (300), bluesky_detached_quotes_full (50), bluesky_rejected (Bluesky refused it; its reason is in error).
  • 401 — bluesky_reauth_required: reconnect the Bluesky account.
  • 403 — bluesky_not_owner: pin, reply/quote settings and hiding replies only work on the account's own posts and threads.
  • 404 — bluesky_post_not_found: deleted, or not visible to this account.
  • 409 — bluesky_record_changed: the record changed in the Bluesky app while we were updating it. Retry. bluesky_action_in_progress: the same action on the same post is still running (or may have gone through); check before retrying.
  • 429 — bluesky_daily_interaction_limit (see above), bluesky_rate_limited (Bluesky's own limit for the account; wait retry_after seconds) or 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 is temporarily limiting requests; retry in a few minutes. bluesky_feature_disabled: the action is not enabled yet. bluesky_guard_unavailable: temporarily unavailable; retry in a minute. 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).
  • 504 — bluesky_write_unconfirmed: Bluesky did not confirm the change; check before retrying.