The API reference moved here from eksis.io/developers.

Bluesky

Bluesky publishes text, photo and video. Text-only posts are allowed (text). Media accepted: images and video. Comments can be read, and you can reply, hide and like them. Direct messages are not available. Post metrics are available. A first comment can be posted right after publishing. eksis publishes at most 300 posts per account per rolling 24 hours.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
TexttextText only.NoneText only
PhotophotoOne or more images.1 to 4Images
VideovideoOne MP4 video.1Video

Media requirements

Photo (photo)

  • Images: up to 1.9 MB, aspect ratio 0.05:1 to 20:1, at least 320 px wide.

Video (video)

  • Video: MP4, up to 286.1 MB, 0.1 s to 10 min long, aspect ratio 0.05:1 to 20:1.

Text limits

FieldLimitUnitNote
caption300characters as shown (graphemes)A whole emoji counts as one.
caption3,000bytesUTF-8 bytes, checked alongside the grapheme limit.
firstComment2,200characters

Settings

Options for Bluesky go in targets[].settings of create and update post requests.

eksis optionFieldTypeValuesRequiredApplies to
Who can reply: Who can reply.settings.replySettingsstringeveryone, mentioned, followers, following, nobodyNoAll types
Allow quote posts: Let others quote the post.settings.allowQuotesbooleanNoAll types

A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.

Example target
{
  "channelId": "CHANNEL_ID",
  "contentType": "text",
  "settings": {
    "replySettings": "everyone",
    "allowQuotes": true
  }
}

Comments and messages

  • First comment: supported.
  • Comments: read, reply, hide and like.
  • New comments reach eksis: checked every 10 minutes.
  • Private reply to a comment: not supported.
  • Direct messages: not available. eksis connects with an app password that has no access to your Bluesky direct messages.

Analytics

  • Post metrics: likes.
  • Audience: follower count is tracked.

Daily limit

eksis publishes up to 300 posts per Bluesky channel a day. Bluesky itself allows 11,666 posts per account a day. A post over the limit is postponed, not failed.

Good to know

  • Links, mentions, and hashtags become clickable. A mention that cannot be resolved stays plain text.
  • replySettings and allowQuotes are applied right after the post exists. If that step fails, the post stays up without them.

Webhook events

Events a Bluesky channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page