# Console API

**URL:** https://heroiclabs.com/docs/satori/console/
**Keywords:** console api, satori
**Categories:** satori, console

---


# Console API

The Satori Console API is the programmatic equivalent of the Satori console: the management API for your instance. It exposes the same capabilities the console offers, including managing flags, audiences, experiments, live events, message schedules and templates, metrics, schemas, webhooks, integrations, and users, as well as importing and exporting data and sending messages directly. It's a privileged, server-side API intended for your backend and tooling.

## Authentication

To communicate with the Satori Console API you must use a [Server key](../concepts/settings/#server-keys).

Server keys are passed as the username in a HTTP Basic Authentication header, with an empty password:

```bash
Authorization: Basic <base64(server_key:)>
```

For example, if your server key is `my_server_key_123`, you would base64 encode `my_server_key_123:` (note the trailing colon for the empty password) and use it in the header:

```bash
curl -X GET "https://api.satori.io/v1/console/..." \
  -H "Authorization: Basic bXlfc2VydmVyX2tleV8xMjM6"
```

{{< note "important" >}}
Server keys and API keys are not interchangeable. See [API keys](../concepts/settings/#api-keys) to learn more about the differences.
{{< /note >}}

## API Reference

<!-- This file is located on static/specs/-->
{{< swagger spec="specs/satori-yaml.yaml" >}}