Bluesky APIthrough Siar.

At a glance

Account needed: A Bluesky account.

Media rules

What Siar can do on Bluesky

Siar can create comments and replies up to 300 characters, and import the comments people leave on your posts.

Publish a post

Put Bluesky's payload under data.BLUESKY and list BLUESKY in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "Bluesky post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "BLUESKY"
    ],
    "data": {
      "BLUESKY": {
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ],
        "tags": [
          "string"
        ]
      }
    }
  }'

Bluesky fields

• text string nullable
• uploadIds string[] nullable
• tags string[] nullable max 8 items
• labels string[] nullable
  One of: !no-unauthenticated porn sexual nudity graphic-media
• quoteUri string max length 512pattern ^at:\/\/\S+$
• externalUrl string nullable uri
• externalTitle string nullable
• externalDescription string nullable
• thumbnail string nullable urimax length 2,048
• videoAlt string nullable max length 10,000

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a Bluesky account

The user enters their handle and an app password; Siar stores it encrypted. Nothing about their main password is ever requested. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• atproto
• transition:generic

Bluesky-specific operations

These exist for Bluesky only and live under /misc/bluesky.

When Bluesky says no

Siar relays Bluesky's error code and message verbatim on the post, next to a status you can act on. The Bluesky error reference covers 10 common cases with what each one means and the fix. Open the Bluesky error reference.