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.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)