Modbot Docs
APIAPI referenceBluesky

Change the Bluesky profile

PUT/api/bluesky/profile

Changes 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.

AuthorizationBearer <token>

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}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.