# API reference

> The Sypnia HTTP API: one API for the open-source engine and for Sypnia Cloud, with every endpoint, parameter, response and error.

Applies to: the Sypnia engine (open source, self-hosted) and Sypnia Cloud (paid service). Status: at launch.  
Source: https://docs.sypnia.com/api/

For agents: Index of the Sypnia HTTP API reference. Base URL https://api.sypnia.com/v1 (self-hosted: <base URL>/v1). Start with Overview and authentication; conventions are on Errors, limits, pagination. The contract is spec/openapi.yaml.

**\[Engine]** **\[Cloud]** Everything Sypnia knows about your app is in this API: problems with their cause, sessions and their replays, traces, performance, uptime, alerts. The app, the Console, the MCP server and the CLI are built on it, so anything they show, your own code can read.

It is the same API on a self-hosted engine and on Sypnia Cloud. An endpoint that exists in only one says so with a badge.

```bash
curl "https://api.sypnia.com/v1/problems?status=open" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

|             |                                                                                                               |
| ----------- | ------------------------------------------------------------------------------------------------------------- |
| Base URL    | `https://api.sypnia.com/v1` on Sypnia Cloud, `<your base URL>/v1` on your engine                              |
| Credentials | An API token (`sps_…`) to read and manage; an ingest key (`spk_…`) to send; the root token on your own engine |
| Format      | JSON in, JSON out. Timestamps in UTC                                                                          |
| Contract    | `spec/openapi.yaml` in the docs repository, OpenAPI 3.1. These pages are generated from it                    |

## Start here

## Read

## Send and manage
