Changelog

A reverse-chronological log of API changes. Subscribe to updates via the Webhooks API or check this page periodically.

Versioning and deprecation policy

The API is versioned through the URL path (/api/v1). Additive changes, such as new endpoints, new optional parameters, new response fields, and new enum values, are non-breaking and are announced in this changelog. Breaking changes only ship in a new version path.

When an endpoint or version is deprecated, it keeps working for at least 90 days. The deprecation is announced in this changelog and by email to owners of active API keys.

v1.9August 1, 2026
New Feature
  • •First Comment (auto-plug): pass firstComment (plain string) or firstComments ([{target, text}]) on POST /api/v1/posts, bulk, threads, validate, and PATCH to auto-post a comment ~15 seconds after the post publishes — the "link in the first comment" workflow. Supported on LinkedIn, Facebook, Instagram, YouTube, X, Threads, Bluesky, and Mastodon; thread-targeted comments (target > 0) on X/Threads/Bluesky via POST /api/v1/threads. Delivery status is reported per account in platforms[].firstComments. Also available in the MCP tools (create_post, bulk_create_posts, create_thread, update_post, validate_post) and the CLI (--first-comment). See Posts.
v1.8July 14, 2026
New FeatureImprovementBreaking Change
  • •Explicit accountId required with multiple accounts (breaking): creating a post without an accountId on a platform where you have MORE than one connected account now returns a 400 listing the choices, instead of silently posting from the first account. Single-account platforms are unchanged. See Posts.
  • •Merged analytics: omit accountId on GET /api/v1/analytics/posts and /analytics/followers to get results across ALL your analytics-enabled accounts in one call (matching best-time). Follower totals exclude YouTube per its API policy. See Analytics.
  • •LinkedIn document (PDF) posts end-to-end: mediaItems[].type: "pdf" is now accepted by the MCP tools, and the in-chat attach_media widget uploads PDFs (100 MB max).
  • •Honest account listing: GET /api/v1/accounts now reports real brandId/brandName (dashboard workspaces) and flags dead tokens with needsReconnect + isConnected: false. Post previews warn about over-limit media counts per platform. The MCP server is v0.8.0.
v1.7July 12, 2026
New Feature
  • •Mastodon on the API: post to all 11 platforms, including per-post platformSettings.mastodon visibility, content warnings, language and polls. See Mastodon.
  • •Media library + list endpoint: upload photos and videos (up to 500 MB) once in the dashboard Media page, then reference them anywhere: GET /api/v1/media lists your recent uploads, and the MCP list_media tool lets AI assistants act on "post my latest upload". This is the path for posting videos from Claude or ChatGPT. See Media.
  • •Inline image upload for AI chats: POST /api/v1/media now also accepts a JSON body with base64 data (images, 3 MB max), so a photo attached in a chat can be posted without a public URL. And the new attach_media tool renders an upload widget IN the conversation: drop a photo or video (up to 500 MB) and it uploads straight to your media library at full quality, ready to post. The MCP server (v0.7.0) exposes 29 tools.
  • •CLI 1.2.0: --media now attaches correctly, new --platform-settings flag, strict flag validation, and scheduling fixes.
v1.6June 11, 2026
New FeatureImprovement
  • •Analytics on all nine platforms: post metrics, follower growth, and best posting times now cover instagram, twitter, bluesky, threads, facebook, linkedin, pinterest, tiktok, and youtube (previously four platforms). See Analytics.
  • •YouTube transcripts and retention: GET /api/v1/engagement/transcript returns a video's caption tracks and parsed transcript; GET /api/v1/analytics/retention returns per-video audience retention for connected YouTube channels.
  • •Feeds (social listening): keyword search via GET /api/v1/feeds/search (bluesky and threads), saved keyword lists via /api/v1/feeds/keywords, and public Bluesky profile lookup via /api/v1/feeds/profile. Results include reply targets that chain into the Engagement API.
  • •Media upload from a URL: POST /api/v1/media/from-url downloads a public image or video and re-hosts it on the Schedulala CDN. See Media.
  • •Claude connector: remote MCP server at /api/mcp with OAuth 2.1; the MCP server now exposes 27 tools. See Claude Connector.
  • •Security hardening: rate limiting on the OAuth and device-flow endpoints, and stricter sandbox isolation for test keys. See Sandbox Mode.
v1.5March 4, 2026
New Feature
  • •Device authorization flow — get API keys from the terminal without a browser sign-up. See Authentication.
  • •Event logging — new event log in the developer dashboard showing API key creation, plan changes, and billing events.
  • •Developer dashboard — real-time usage charts, request logs, and billing overview at Dashboard → Developer.
  • •Documentation overhaul — added Platforms reference, Connecting Accounts guide, and this Changelog.
v1.4March 4, 2026
Improvement
  • •Media dimension validation — upload endpoint now validates image width/height against per-platform minimum dimensions.
  • •Aspect ratio validation — images outside the target platform's allowed aspect ratio range are rejected with a descriptive error.
  • •Video duration validation — videos exceeding a platform's max duration are rejected at upload time instead of failing silently during posting.
  • •GIF support detection — GIFs are now rejected for platforms that don't support them (Instagram, TikTok, Threads, Pinterest, YouTube) with a clear error message.
v1.3March 1, 2026
Breaking Change
  • •Renamed profileId to brandId — all endpoints that accepted profileId now use brandId. The old parameter name will continue to work for 90 days (until June 1, 2026), but will log a deprecation warning.
  • •GET /api/v1/usage — new endpoint returning current billing period usage, rate limit stats, and plan details. See Rate Limits.
v1.2March 1, 2026
New Feature
  • •Stripe billing integration — developer API plans are now billed via Stripe. Manage your subscription at Dashboard → Developer.
  • •Plan management endpoints — GET /api/v1/billing/plan and POST /api/v1/billing/checkout for programmatic plan management.
  • •Usage endpoint — GET /api/v1/usage returns requests used, limits, and reset date for the current billing cycle.
v1.1March 1, 2026
New Feature
  • •Full API launch — 30 endpoints covering posts, threads, queues, media, profiles, accounts, analytics, and webhooks. See the Quickstart.
  • •Webhook delivery — receive real-time notifications for post status changes, account health events, and more. See Webhooks.
  • •Bulk operations — create, update, and delete multiple posts in a single request.
  • •Analytics API — retrieve post performance metrics across all platforms. See Analytics.
v1.0February 28, 2026
New Feature
  • •Initial release — API key authentication, rate limiting, and core data models.
  • •API key management — create, rotate, and revoke API keys from the dashboard. See Authentication.
  • •Rate limiting — tiered rate limits by plan with X-RateLimit-* headers. See Rate Limits.