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":
| Endpoint | Actions |
|---|---|
POST /api/uploadposts/posts/action | like, unlike, repost, unrepost, bookmark, unbookmark, pin, unpin, reply_settings, quote_settings, detach_quote, reattach_quote |
POST /api/uploadposts/posts/repost | repost (same as posts/action with "action": "repost") |
POST /api/uploadposts/posts/save | bookmark (a private Bluesky bookmark) |
POST /api/uploadposts/comments/action | hide, 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
| Name | Value | Description |
|---|---|---|
| Authorization | Apikey your-api-key-here | Your API key for authentication |
| Content-Type | application/json | Request body format |
Post actions
Body Parameters (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
platform | String | Yes | bluesky |
user | String | Yes | Profile username. |
action | String | Yes | One of the actions below. |
post_id | String | Yes (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_settings | String or array | For reply_settings | Same values as bluesky_threadgate on upload: everyone, nobody, or a comma-separated set of mention, following, followers, list:<at:// list URI>. |
quote_settings | String | For quote_settings | disable_quotes (nobody can quote the post) or everyone. |
quote_uri | String | For detach_quote / reattach_quote | The post that quotes yours (at:// URI or bsky.app link). |
| Action | What it does |
|---|---|
like / unlike | Like the post, or remove your like. |
repost / unrepost | Repost the post, or undo your repost. |
bookmark / unbookmark | Save the post to the account's private bookmarks, or remove it. |
pin / unpin | Pin 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_settings | Change 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_settings | Allow or stop quotes of one of the account's own posts. |
detach_quote / reattach_quote | Remove 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".
| Name | Type | Required | Description |
|---|---|---|---|
platform | String | Yes | bluesky |
user | String | Yes | Profile username. |
comment_id | String | Yes | The reply: at:// URI or bsky.app link. |
action | String | Yes | hide, unhide, like, unlike. |
post_id | String | No | The 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 inerror). - 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; waitretry_afterseconds) orbluesky_read_rate_limited(too many Bluesky requests for this Upload-Post account right now; waitretry_afterseconds). - 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 afterretry_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.