Documentation

Build on Ollanode.

One project-scoped REST API for video, CDN, storage, DNS, edge compute, and governance. Every feature is an endpoint; every example below is a real call you can run against your own deployment.

Base https://api.ollanode.com OpenAPI 3.1 MCP for agents

Base URL & authentication

All control-plane requests go to https://api.ollanode.com and carry a bearer credential — either a vbk_ API key or a dashboard session token — in the Authorization header (the x-api-key header is also accepted). Create keys in the dashboard under API Keys.

your first request
curl https://api.ollanode.com/v1/whoami \
  -H "Authorization: Bearer $OLLANODE_API_KEY"

GET /v1/whoami returns who you are and a per-action capability map — the fastest way to confirm a key works and see what it can do.

Conventions in 30 seconds

Scopes are coarse (read, write, admin) or fine-grained (resource:action, e.g. videos:write); a coarse preset satisfies the matching fine-grained checks. Errors are { "error": { "code", "message" } } with conventional HTTP statuses. Lists page with ?limit= (default 25, max 100) & ?offset= and return { items, total, limit, offset }. Writes accept an Idempotency-Key; every response carries X-Request-Id and rate-limit headers. Full detail on the Authentication & scopes page.

Explore the API