API Changelog

All notable changes to the SocialRails Public API are documented here. We follow semantic versioning for the API, and breaking changes will always be announced in advance.

March 2026

v1.4.0: Threading API, Discovery Endpoints, Platform Settings

New Endpoints

• GET /api/v1/accounts/:id/settings — Get platform capabilities, character limits, media specs, workspace defaults, and available tools for a connected account.
• POST /api/v1/accounts/:id/tools — Trigger platform discovery tools (Facebook pages, Pinterest boards, LinkedIn companies, Twitter communities).

New Features

• Threading API — Create Twitter and Threads reply chains via POST /api/v1/posts using the new thread, thread_media, and thread_delay fields. Supports 2-25 items per thread with per-platform character limits.
• Platform Settings Documentation — New dedicated Platform Settings Reference documenting all 9 platforms with character limits, media specs, threading support, settings fields, and examples.
• socialrails CLI — New standalone CLI package on npm for scheduling posts, managing accounts, generating AI content, and viewing analytics from the terminal. JSON output for scripting and AI agent integration.

Improvements

• OpenAPI spec — Added PlatformCapabilities and PlatformSettings schemas, thread fields on CreatePostRequest.
• n8n package — Expanded README with installation methods, operations reference, workflow examples, platform notes, and troubleshooting.

---

v1.3.0: Media Uploads, Batch Posting, Full CRUD

New Endpoints

• POST /api/v1/posts/batch, Create posts for multiple platforms in a single request. Posts are linked by a batch_id.
• POST /api/v1/media/upload, Upload images and videos via multipart form data (up to 10MB).
• POST /api/v1/media/upload-url, Upload media by providing a URL to fetch from.
• DELETE /api/v1/posts/:id, Delete draft or scheduled posts.
• PATCH /api/v1/posts/:id, Update content, platform, or schedule for draft/scheduled posts.
• GET /api/v1/health, Public health check endpoint (no authentication required).

Coming Soon

• POST /api/v1/webhooks, Register webhook URLs to receive event notifications.
• GET /api/v1/webhooks, List your registered webhooks.
• DELETE /api/v1/webhooks/:id, Remove a webhook registration.
• Webhook event delivery (post.published, post.failed, post.scheduled) will be enabled in a future update. You can already register endpoints via the API.

Improvements

• Posts list: Added sort, platform, from, and to query parameters for filtering and sorting.
• Analytics: Added 365d period option and per-post analytics via post_id query parameter.
• Accounts: Response now includes status field (connected or expired).
• Workspace: Response now includes usage object with posts_this_month count and full plan limits.
• Batch posting: New batch_id field links posts created together.
• Media support: Posts now accept optional media field (array of R2 keys from the upload endpoint).

Infrastructure

• Router refactored to declarative route table for cleaner endpoint management.
• CORS now allows DELETE and PATCH methods.
• Body size limit increased to 10MB for media upload endpoints.

v1.2.0: Initial Public API

• GET /api/v1/posts, List scheduled posts with pagination
• GET /api/v1/posts/:id, Get a single post
• POST /api/v1/posts, Create and schedule posts
• GET /api/v1/analytics, Aggregate publishing analytics
• GET /api/v1/accounts, List connected social accounts
• POST /api/v1/ai/generate, AI content generation
• GET /api/v1/workspace, Workspace info and plan limits

Versioning Policy

The SocialRails API uses URL-based versioning (/api/v1/). We will:

• Never remove or rename existing fields in a response without a version bump
• Always announce breaking changes at least 30 days in advance
• Add new optional fields to responses without a version bump (additive changes are non-breaking)