API Overview

Base URL

https://admin.vibescaling.org/api/v1

All API requests require authentication via API key:

Authorization: Bearer vs_your_api_key

Create API keys in Settings → API Keys in your dashboard.

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`	Archive a post
POST	`/posts/:id/assets`	Get presigned upload URL for slide
POST	`/posts/:id/publish`	Publish a post to TikTok

Rate limits depend on your plan and apply to API key requests only:

Rate limit headers are included in every response:

When rate limited, you'll receive a 429 response with a Retry-After header.

All responses return JSON:

{
  "data": { ... }
}

Errors return:

{
  "error": "Description of the error"
}