v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Connect

Connect Bluesky account

Connect a Bluesky account using identifier (handle or email) and an app password. To get your userId for the state parameter, call GET /v1/users which includes a currentUserId field.

post/v1/connect/bluesky/credentials

Request body

identifierstring required

Your Bluesky handle (e.g. user.bsky.social) or email address

appPasswordstring required

App password generated from Bluesky Settings > App Passwords

statestring required

Required state formatted as {userId}-{profileId}. Get userId from GET /v1/users and profileId from GET /v1/profiles.

redirectUristring uri

Optional URL to redirect to after successful connection

Example request

{
  "state": "6507a1b2c3d4e5f6a7b8c9d0-6507a1b2c3d4e5f6a7b8c9d1"
}

Response

Bluesky connected successfully

messagestring