Skip to main content
The Sevalla API is a REST API for managing your company’s services and settings: applications, deployments, processes, databases, static sites, object storage, load balancers, pipelines, projects, domains, environment variables, webhooks and API keys. It sends and receives JSON over HTTPS, and every request is authenticated with an API key.

​
Make your first request

1

Create an API key

In the Sevalla dashboard, under Tools, click API keys, then create a key. The Company viewer role is enough to read. Copy the key when it’s shown, and keep it in an environment variable:
2

List your applications

Send the key as a bearer token to List applications:
3

Read the response

The API returns the first page of the company’s applications, ordered by name:
Each application’s id is what other operations take, for example POST /applications/{id}/deployments to trigger a deployment. Pagination explains total, offset and limit.
To see what a key is allowed to do, call Get current API key (GET /api-keys/me).

​
What you can manage

Applications

Create, deploy and roll back applications, and manage their processes, domains, environment variables, networking, logs and metrics.

Pipelines

Stages, promotions without a rebuild, and preview apps for pull requests.

Databases

PostgreSQL, MySQL, MariaDB, Redis and Valkey, with backups, restores and internal connections.

Static sites

Deployments, custom domains, environment variables, cache purges, logs and metrics.

Object storage

Buckets, objects, CORS policies, the CDN domain and S3 credentials.

Load balancers

Destinations and custom domains.

Projects

Group applications, databases, pipelines and buckets, and move services between projects.

Webhooks

Endpoints, events, signing secrets and deliveries.
The reference also covers global environment variables, registry credentials, API keys, usage alerts, company users, and resources such as locations and sizes.

​
Guides

  • Authentication: API keys, the Authorization header, permissions, and 401 and 403 responses.
  • Errors: the error body, every status code, and which errors to retry.
  • Rate limits: the six limit tiers, the x-ratelimit-* headers and 429.
  • Pagination: limit, offset and total on list operations.
  • Long-running operations: operations that finish in the background, and how to poll for the result.
  • Webhook events: the requests Sevalla sends to your webhook endpoint.

​
Tools built on the API

These tools call this API with the same API keys, so you don’t always need to call it by hand.

Sevalla CLI

Commands for a terminal or a CI job, with JSON output.

MCP server

AI agents that deploy, debug and manage services.

Terraform provider

Services defined as code.

​
OpenAPI spec

The spec is generated from the API’s code, and every operation page in this reference is built from it. Download it without an API key, as JSON from https://api.sevalla.com/v3/openapi.json or as YAML from https://api.sevalla.com/v3/openapi.yaml. For LLMs and agents, https://api-docs.sevalla.com/llms.txt lists every page of this reference with its description.