Skip to main content
The Volta public REST API gives you full programmatic control over your social media publishing workflow. Every feature available in the Volta dashboard — scheduling posts, connecting channels, uploading media, and reading analytics — is accessible through versioned, stable endpoints under the /public/v1 prefix. All requests are authenticated with your organization’s API key, and responses are returned as JSON.

​
Base URL

All API endpoints are relative to your Volta instance: 
https://your-instance.com/public/v1
For organizations on the Volta hosted service, the base URL is: 
https://api.postsider.com/public/v1

​
Authentication

Every request must include your API key in the Authorization header. No Bearer prefix is needed — pass the raw key value: 
curl -H 'Authorization: your-api-key' \
  https://your-instance.com/public/v1/integrations
You can generate and manage API keys from Settings → API Keys in the Volta dashboard. Each key is scoped to your organization and never expires.
Treat your API key like a password. Anyone with your key has full access to your organization’s posts, channels, and media. Rotate keys immediately if they are ever exposed.

​
Rate Limiting

The API enforces a limit of 60 requests per minute per organization. Every response includes the following headers so you can track your usage:
HeaderDescription
X-RateLimit-LimitMaximum number of requests allowed per window
X-RateLimit-RemainingNumber of requests remaining in the current window
X-RateLimit-ResetUnix timestamp (UTC) when the current window resets
When you exceed the limit, the API returns 429 Too Many Requests. Back off until the time indicated by X-RateLimit-Reset before retrying.

​
Request & Response Format

All request bodies must be sent as JSON with the Content-Type: application/json header. All responses are returned as JSON. File uploads to the /upload endpoint use multipart/form-data instead.

​
Error Codes

The API uses standard HTTP status codes to communicate errors. The response body contains additional context where available.
CodeMeaning
400Invalid request body — check the required fields for the endpoint
401Invalid or missing API key
402Subscription limit reached — you have hit your plan’s channel or post quota
404Resource not found — the post or channel ID does not exist
429Rate limit exceeded — slow down and retry after X-RateLimit-Reset

​
Endpoints

The following endpoints are available in the public API:

Posts

Schedule, list, and delete posts across connected channels.

Channels

List connected channels, browse connectors, and authorize new platforms.

Media

Upload images and videos to the Volta media library.

​
Full Endpoint Reference

MethodPathDescription
POST/public/v1/postsSchedule or draft a post
GET/public/v1/postsList posts with optional filters
DELETE/public/v1/posts/:idDelete a post by ID
POST/public/v1/uploadUpload a media file
GET/public/v1/integrationsList connected channels
GET/public/v1/connectorsList available connector types
POST/public/v1/connectors/:id/authorizeStart OAuth authorization for a connector
GET/public/v1/connectors/:id/analyticsGet analytics for a connected channel
If you are using Node.js or TypeScript, the @postsider/node SDK wraps all of these endpoints with a fully-typed client. See the SDK Overview to get started.