Bluesky: follows, blocks, lists and reports
Manage who the connected Bluesky account follows, blocks and mutes, its lists and starter packs, feeds it declares, and reports to Bluesky's moderation. Every endpoint takes user (the profile username) in the query string or the body.
One target per call. Bluesky's Developer Guidelines do not allow automated or bulk follows, likes or other interactions, so there is no batch mode, and follows and list additions count toward the daily limits on likes, reposts and follows. Repeating the same follow, block or list addition within two minutes returns the first answer ("replayed": true).
These endpoints are not generally available yet: until they are, they answer 503 bluesky_feature_disabled.
Accounts can be given as a handle (name.bsky.social or @name.bsky.social), a DID (did:plc:...) or a bsky.app profile link. Lists as an at:// URI, a bsky.app list link, or (for the account's own lists) their id.
Follow, block, mute
POST /api/uploadposts/bluesky/graph
action | Needs | What it does |
|---|---|---|
follow / unfollow | actor | Follow or unfollow. Counts toward the daily limit. |
block / unblock | actor | Block (public on Bluesky) or unblock. |
mute / unmute | actor | Mute privately. Optional only_reposts / only_quoteposts (true) mute just that content. |
mute_list / unmute_list | list | Mute every account in a list. |
block_list / unblock_list | list | Block every account in a moderation list (moderation lists only). |
mute_thread / unmute_thread | post_id | Stop notifications from a thread (first post of the thread). |
curl -X POST https://api.upload-post.com/api/uploadposts/bluesky/graph \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{"user": "my-profile", "action": "follow", "actor": "partner.bsky.social"}'
{"success": true, "platform": "bluesky", "action": "follow", "actor": "did:plc:xyz789",
"record_uri": "at://did:plc:abc123/app.bsky.graph.follow/3lbq...", "changed": true}
Following an account you already follow (or unblocking one you never blocked) answers "changed": false and is not counted.
Lists
GET /api/uploadposts/bluesky/lists?user=my-profile[&purposes=modlist,curatelist][&cursor=]
POST /api/uploadposts/bluesky/lists
GET /api/uploadposts/bluesky/lists/{list_id}?user=my-profile
PATCH /api/uploadposts/bluesky/lists/{list_id}
DELETE /api/uploadposts/bluesky/lists/{list_id}
Create/update fields: name (required to create, up to 64 bytes), purpose (curatelist for a list of accounts people can follow as a feed, modlist for moderation, referencelist for starter packs), description (up to 300 characters), avatar file or avatar_url (PNG/JPEG up to 1,000,000 bytes), remove_avatar.
DELETE needs "confirm": true and also removes the list's members. A big list is emptied in batches: while the answer says "done": false, send the same DELETE again; the list itself goes when it is empty. GET with a list id answers the list and its members (items, cursor).
On PATCH, empty values leave a field unchanged; send null or clear_fields to remove description or avatar. Sending the same POST again within 10 minutes returns the list created the first time.
Members
GET /api/uploadposts/bluesky/lists/{list_id}/members?user=my-profile
POST /api/uploadposts/bluesky/lists/{list_id}/members {"user": "my-profile", "actor": "name.bsky.social"}
DELETE /api/uploadposts/bluesky/lists/{list_id}/members {"user": "my-profile", "actor": "name.bsky.social"}
Stay out of someone else's reference list
POST /api/uploadposts/bluesky/lists/opt-out {"user": "my-profile", "list": "at://.../app.bsky.graph.list/..."}
DELETE /api/uploadposts/bluesky/lists/opt-out (withdraw the request)
Starter packs
GET /api/uploadposts/bluesky/starter-packs?user=my-profile
POST /api/uploadposts/bluesky/starter-packs
GET /api/uploadposts/bluesky/starter-packs/{pack_id}?user=my-profile
PATCH /api/uploadposts/bluesky/starter-packs/{pack_id}
DELETE /api/uploadposts/bluesky/starter-packs/{pack_id}
Create: name (up to 50 characters), description (up to 300), feeds (up to 3 feed at:// URIs), and either list (one of the account's lists) or members (up to 25 accounts per request; a new list is created for the pack, and you add more members afterwards through POST /lists/{list_id}/members). If creating the pack fails, the list made for it is removed. PATCH changes name, description and feeds. DELETE needs "confirm": true; add "delete_list": true to also delete the pack's list.
Feeds
GET /api/uploadposts/bluesky/feeds?user=my-profile
POST /api/uploadposts/bluesky/feeds
PATCH /api/uploadposts/bluesky/feeds/{rkey}
DELETE /api/uploadposts/bluesky/feeds/{rkey}
Declare, on the account, a custom feed served by a feed generator service: rkey (the feed's short name in its URL, 1-15 letters, digits or dashes), did (the feed service's DID), display_name (up to 24 characters), description, avatar, accepts_interactions, content_mode (unspecified or video). Upload-Post does not run the feed service itself. DELETE needs "confirm": true.
Report to Bluesky moderation
POST /api/uploadposts/bluesky/report
| Name | Required | Description |
|---|---|---|
post_id or actor | One of them | The post or the account to report. |
reason_type | Yes | spam, violation, misleading, sexual, rude, other, appeal, or one of Bluesky's detailed tools.ozone.report.defs#reason... values. |
reason | No | Context for the moderators, up to 2,000 characters. |
confirm | Yes | true. A report reaches Bluesky's moderators and cannot be withdrawn. |
Up to 20 reports per Bluesky account per UTC day, with daily limits per Upload-Post account and for Upload-Post as a whole too (429 bluesky_daily_report_limit). The same report (same target and reason) is sent once per 24 hours; repeating it returns the first answer. An account can report itself only to appeal (reason_type: "appeal").
{"success": true, "platform": "bluesky", "action": "report", "report_id": 123456,
"reason_type": "com.atproto.moderation.defs#reasonSpam", "subject": "at://did:plc:xyz789/app.bsky.feed.post/3lbq...", "changed": true}
Error Responses
- 400 —
unsupported_action,missing_actor,invalid_actor,missing_list,missing_post_id,bluesky_bulk_not_allowed,bluesky_self_target,bluesky_not_modlist,invalid_purpose,too_many_feeds,too_many_members,invalid_feed_id,invalid_did,invalid_reason_type,invalid_report_subject,confirmation_required,nothing_to_change,bluesky_rejected. - 401 —
bluesky_reauth_required. 403 —bluesky_not_owner. - 404 —
bluesky_not_found,bluesky_actor_not_found,bluesky_post_not_found. - 409 —
bluesky_record_changed,bluesky_feed_exists,bluesky_action_in_progress. - 429 —
bluesky_daily_interaction_limit,bluesky_daily_report_limit,bluesky_rate_limited,bluesky_read_rate_limited. - 503 —
bluesky_feature_disabled,bluesky_edge_rate_limited,bluesky_guard_unavailable,bluesky_read_capacity,bluesky_login_unavailable.