API Overview
Vibescaling REST API reference
Base URL
https://admin.vibescaling.org/api/v1Authentication
All API requests require authentication via API key:
Authorization: Bearer vs_your_api_keyCreate API keys in Settings → API Keys in your dashboard.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /posts | List posts (paginated) |
| POST | /posts | Create a new post |
| GET | /posts/:id | Get a single post |
| PATCH | /posts/:id | Update a post |
| DELETE | /posts/:id | Delete a post (draft/archived only) |
| PATCH | /posts/batch | Batch archive posts |
| POST | /posts/:id/assets | Get presigned upload URL for slide or video |
| GET | /posts/:id/assets | List assets with presigned URLs |
| POST | /posts/:id/publish | Publish a post to TikTok |
| GET | /posts/:id/publish-status | Check TikTok publish status |
| GET | /tiktok-accounts | List connected TikTok accounts |
| GET | /analytics | Get analytics summary |
Rate Limits
Rate limits depend on your plan and apply to API key requests only. During the free trial, Growth-level limits apply. See Rate Limits for details.
| Plan | Requests/minute |
|---|---|
| Growth | 60 |
| Agency | 300 |
| API Only | 60 |
Rate limit headers are included in every response:
X-RateLimit-Limit— max requests per windowX-RateLimit-Remaining— remaining requestsX-RateLimit-Reset— window reset time (Unix timestamp)
When rate limited, you'll receive a 429 response with a Retry-After header.
Response Format
All responses return JSON:
{
"data": { ... }
}Errors return:
{
"error": "Description of the error"
}HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Invalid request |
| 401 | Unauthorized |
| 404 | Not found |
| 409 | Conflict (e.g. video already exists) |
| 413 | Payload too large (video exceeds 4GB) |
| 429 | Rate limit exceeded |
| 500 | Server error |