Publora Bluesky

Post or schedule content to Bluesky using the Publora API. Use this skill when the user wants to publish or schedule Bluesky posts via Publora.

Bluesky (AT Protocol) platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.

Base URL: https://api.publora.com/api/v1
Header: x-publora-key: sk_YOUR_KEY
Platform ID format: bluesky-{did}

Where {did} is your Bluesky Decentralized Identifier (DID), assigned on connection.

Requirements

• A Bluesky account connected via username + app password (not your main password)
• Generate an app password: Bluesky Settings → App Passwords
• Connected through the Publora dashboard

Platform Limits (API)

Property	Limit	Notes
Text	300 characters	⚠️ Links count toward limit in Publora's validation
Images	Up to 4 × ~976 KB	All formats accepted; Publora converts everything to JPEG before upload
Image dimensions	Max 2000×2000 px	—
Video	3 min / 100 MB	MP4; email verification required
Video (short)	<60s → 50 MB	Size tiers apply
Text only	✅ Yes	—
Daily video limit	25 videos / 10 GB	—
Rate limit	3,000 req/5 min	—

Common errors:

• 429 Too Many Requests — rate limit exceeded, wait and retry
• Video JOB_STATE_FAILED — check format (MP4) and size tier

Post a Skeet (text post)

await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Building in public on Bluesky today! Links, hashtags, and mentions all auto-detected. #buildinpublic',
    platforms: ['bluesky-did:plc:abc123']
  })
});

Publora automatically detects hashtags, URLs, and @mentions and creates proper AT Protocol facets.

Schedule a Post

body: JSON.stringify({
  content: 'Your Bluesky post here',
  platforms: ['bluesky-did:plc:abc123'],
  scheduledTime: '2026-03-20T11:00:00.000Z'
})

Post with Image

⚠️ Bluesky has a strict 1 MB limit per image. Compress to 80–85% JPEG quality.

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# Step 1: Create post
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'Check out this photo! 📸',
    'platforms': ['bluesky-did:plc:abc123']
}).json()

# Step 2: Get upload URL (make sure image is <1 MB and JPEG/PNG/WebP)
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'postGroupId': post['postGroupId'],
    'fileName': 'photo.jpg',
    'contentType': 'image/jpeg',
    'type': 'image'
}).json()

# Step 3: Upload
with open('photo_compressed.jpg', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)

Platform Quirks

• Links count in Publora's validation: Bluesky natively excludes link URLs from the char count, but Publora validates against content.length — so links DO consume your 300-char budget. Plan accordingly.
• All images → JPEG: Publora converts ALL uploaded formats (PNG, WebP, GIF, TIFF, BMP) to JPEG via sharp before uploading to Bluesky. No manual conversion needed.
• Image size is ~976 KB (not 1 MB): Publora enforces 976.56 × 1024 bytes. Compress images to 80–85% JPEG quality to stay under.
• Auto-facets: Publora automatically detects #hashtags and URLs and creates proper Bluesky facets with correct byte offsets (handles emojis and multi-byte chars correctly)
• altTexts silently ignored in API: The altTexts array in create-post is NOT currently processed — it will be silently ignored. Alt text is only available through the Publora dashboard.
• test-connection always fails for Bluesky: Known bug — the validator checks for accessToken but Bluesky uses password. Connection still works for posting; ignore this status.
• App password required: Never use your main Bluesky password; create a dedicated app password in Settings → App Passwords
• Email verification required before video uploads (one-time step in Bluesky settings)
• DID format: Platform ID uses the full DID, e.g. bluesky-did:plc:abc123xyz