Changelog
All notable changes to the PostBoost API are documented here.
Base URL for all endpoints: https://postboost.co/app/api
v5.5.0 — 2026-04-11
New API Endpoints
AI — Image Generation & Editing
| Method | Endpoint | Description |
|---|---|---|
POST | /{workspaceUuid}/ai/image-prompt | Build an optimized image generation prompt from a social media caption and platform. Use this to preview the prompt before calling image-generate. Costs 1 AI credit per call. |
POST | /{workspaceUuid}/ai/image-generate | Generate one or more social media images from a caption (standard mode) or a raw prompt (developer mode). Images are saved directly to the workspace media library. Credits: count × credit_weight (default 5 per image). |
POST | /{workspaceUuid}/ai/image-edit | Edit an existing workspace media image using a text prompt and optional mask. Results are saved to the media library. Credits: count × credit_weight. |
POST | /{workspaceUuid}/ai/image-variations | Generate one or more variations of an existing workspace media image. Results are saved to the media library. Credits: count × credit_weight. |
POST | /{workspaceUuid}/ai/image-alt-text | Analyze an existing workspace media image and generate accessible alt text. The alt text is saved back to the media record. Costs 1 AI credit per call. |
No breaking API changes.
v5.4.0 — 2026-04-04
New API Endpoint
AI
| Method | Endpoint | Description |
|---|---|---|
POST | /{workspaceUuid}/ai/blog-to-social | Generate platform-specific social media captions from a blog post URL or title and excerpt. Supports tone, hashtags, CTA, language, and optional draft post creation with image import. Consumes one AI credit per platform. |
No breaking API changes.
v5.3.1 — 2026-03-23
Platform Improvements
- Added Mastodon service management endpoints
- Facebook API updated to v25.0
- Improved HEIC and HEIF image upload support
- Post status is now set to
DRAFTwhen moved to trash
Media
- Chunked upload support for large files —
POST /{workspaceUuid}/media/chunked/initiate - Remote media download from URL —
POST /{workspaceUuid}/media/remote/initiate - Compatible with more video formats (MP4, MOV, AVI, WebM)
- Additional image format support
- Resolved infinite loading issue in Media Library
No breaking API changes.
v5.2.0 — 2025-12-29
New API Endpoints
Workspaces (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/workspaces | List all workspaces |
POST | /panel/workspaces | Create workspace |
GET | /panel/workspaces/{uuid} | Get workspace |
PUT | /panel/workspaces/{uuid} | Update workspace |
DELETE | /panel/workspaces/{uuid} | Delete workspace |
DELETE | /panel/workspaces | Bulk delete workspaces |
POST | /panel/workspaces/{uuid}/users | Add user to workspace |
PUT | /panel/workspaces/{uuid}/users | Update user role |
DELETE | /panel/workspaces/{uuid}/users | Remove user from workspace |
Subscriptions (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/workspaces/{uuid}/subscription | Get subscription |
POST | /panel/workspaces/{uuid}/subscription | Create subscription |
PUT | /panel/workspaces/{uuid}/subscription | Update subscription |
DELETE | /panel/workspaces/{uuid}/subscription | Delete subscription |
POST | /panel/workspaces/{uuid}/subscription/new | Checkout new subscription |
PUT | /panel/workspaces/{uuid}/subscription/change-plan | Change plan |
POST | /panel/workspaces/{uuid}/subscription/cancel | Cancel subscription |
POST | /panel/workspaces/{uuid}/subscription/resume | Resume subscription |
POST | /panel/workspaces/{uuid}/subscription/generic | Add generic subscription |
DELETE | /panel/workspaces/{uuid}/subscription/generic | Remove generic subscription |
Users (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/users | List users |
POST | /panel/users | Create user |
GET | /panel/users/{id} | Get user |
PUT | /panel/users/{id} | Update user |
DELETE | /panel/users/{id} | Delete user |
DELETE | /panel/users | Bulk delete users |
Receipts (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/receipts | List receipts |
POST | /panel/receipts | Create receipt |
GET | /panel/receipts/{id} | Get receipt |
PUT | /panel/receipts/{id} | Update receipt |
DELETE | /panel/receipts/{id} | Delete receipt |
DELETE | /panel/receipts | Bulk delete receipts |
v5.1.0 — 2025-08-15
Initial Release
Workspace endpoints (workspace API token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /{workspaceUuid}/accounts | List connected social accounts |
GET | /{workspaceUuid}/accounts/{id} | Get account |
GET | /{workspaceUuid}/posts | List posts |
POST | /{workspaceUuid}/posts | Create post |
GET | /{workspaceUuid}/posts/{uuid} | Get post |
PUT | /{workspaceUuid}/posts/{uuid} | Update post |
DELETE | /{workspaceUuid}/posts/{uuid} | Delete post |
DELETE | /{workspaceUuid}/posts | Bulk delete posts |
POST | /{workspaceUuid}/posts/schedule/{uuid} | Schedule post |
POST | /{workspaceUuid}/posts/add-to-queue/{uuid} | Add to queue |
POST | /{workspaceUuid}/posts/approve/{uuid} | Approve post |
GET | /{workspaceUuid}/media | List media |
POST | /{workspaceUuid}/media | Upload media |
GET | /{workspaceUuid}/media/{id} | Get media |
PUT | /{workspaceUuid}/media/{id} | Update media |
DELETE | /{workspaceUuid}/media | Delete media |
GET | /{workspaceUuid}/tags | List tags |
POST | /{workspaceUuid}/tags | Create tag |
GET | /{workspaceUuid}/tags/{id} | Get tag |
PUT | /{workspaceUuid}/tags/{id} | Update tag |
DELETE | /{workspaceUuid}/tags/{id} | Delete tag |