Change the Bluesky profile
/api/bluesky/profileChanges the account's name, bio, picture and banner on Bluesky, and nothing else on the profile (the pin and every other field stay as they are). Needs Manage settings. The body is a multipart form: text fields displayName (at most 64 characters) and bio (at most 256) and files avatar and banner (a PNG or JPEG under 1 MB each). A field that is not sent is kept; an empty text field clears it. Answers with the profile as saved. 400 for nothing to save, a value over its limit, or an account that is not set up; 413 for a picture over 1 MB; 429 when Bluesky is limiting Modbot or a save came within 10 seconds of the last one (a 429 is never retried); 409 when the profile was changed on Bluesky meanwhile; 502 for any other failure. A failed save shows on Health and in SaveError.
Needs the ManageSettings permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X PUT "https://example.com/api/bluesky/profile" \ -F displayName="null" \ -F bio="null" \ -F avatar="null" \ -F banner="null"{ "state": "string", "problem": null, "handle": null, "displayName": null, "bio": null, "avatarUrl": null, "bannerUrl": null, "followers": null, "following": null, "posts": null, "canEdit": true, "signedIn": true, "limitedUntil": null, "saveError": null, "saveErrorAt": null}Get the Bluesky profile GET
The group's Bluesky account as its profile page shows it: name, handle, bio, picture and banner addresses and the followers, following and posts counts, read from Bluesky's public API (no sign-in). The answer is kept for 10 seconds. State is notSetUp when no account is saved and unavailable when it could not be read (Problem says why). CanEdit is true for a caller who may change the Bluesky settings; SaveError is why the last save failed. Needs the `ViewAnalytics` permission.
List posts sent to Bluesky GET
The posts Modbot sent to the group's Bluesky account, newest first, 20 to a page (page starts at 1), each with its likes, reposts and replies when last counted. Needs the `ViewPosts` permission.