API Overview
Programmatic access to Levercast via the public REST API.
Levercast exposes a versioned REST API at /api/v1 for external integrations, automation workflows, and MCP (Model Context Protocol) clients.
Base URL
https://app.levercast.com/api/v1All endpoints are relative to this base path.
Authentication
Every request must include a bearer API key in the Authorization header:
Authorization: Bearer lc_...See Authentication for how to create and manage API keys.
Response Format
All successful responses wrap data in a data field:
{
"data": { ... }
}Paginated responses include a meta field:
{
"data": [...],
"meta": {
"total": 42,
"limit": 50,
"offset": 0
}
}Error Format
Errors return an error field with a human-readable message:
{
"error": "Missing, invalid, or revoked API key."
}Rate Limiting
API requests are rate-limited per API key. When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header indicating how many seconds to wait.
Available Endpoints
| Resource | Endpoints |
|---|---|
| Auth | GET /me |
| Posts | GET /posts, POST /posts, GET /posts/:id, PATCH /posts/:id, DELETE /posts/:id, POST /posts/:id/publish |
| Tags | GET /tags, POST /tags, PATCH /tags/:id, DELETE /tags/:id |
| Templates | GET /templates |
OpenAPI Specification
A full OpenAPI 3.1 spec is available at /api/v1/openapi.yaml and interactive API documentation at /api/v1/docs.