Publora — Mastodon
Mastodon / Fediverse 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: mastodon-{accountId}
Note: Publora currently posts to the mastodon.social instance. Other instances are not supported at this time.
Platform Limits (API)
| Property | Limit | Notes |
|---|---|---|
| Text (toot) | 500 characters | Instance-configurable; some allow 5,000+ |
| Images | Up to 4 × 16 MB | JPEG, PNG, GIF, WebP |
| Video | ~99 MB | MP4, MOV, WebM; no duration limit, capped by size |
| Text only | ✅ Yes | — |
| Rate limit | 30 media uploads/30 min | 300 requests/5 min per account |
Post a Toot (text)
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: 'Hello Fediverse! Building open, decentralized tools for everyone. #fediverse #opensource',
platforms: ['mastodon-123456789']
})
});
Schedule a Toot
body: JSON.stringify({
content: 'Your Mastodon post here',
platforms: ['mastodon-123456789'],
scheduledTime: '2026-03-20T10:00:00.000Z'
})
Post with Image
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': 'Here is a photo from our event 📷 #community',
'platforms': ['mastodon-123456789']
}).json()
# Step 2: Get upload URL (up to 16 MB, JPEG/PNG/GIF/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.jpg', 'rb') as f:
requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)
Platform Quirks
- mastodon.social only — Publora currently supports this instance
- Generous image limit: 16 MB per image, much more than most platforms
- Video capped by size (~99 MB default) — no explicit duration limit
- WebP supported — unlike Instagram, Mastodon accepts WebP natively
- Federation: Posts federate automatically to the broader Fediverse
- Hashtags: Important for discoverability on Mastodon — use them in posts
- Content warnings: Not directly supported via Publora API yet; use text conventions if needed
