API Overview

Authentication

Requests can be authenticated via an organization API key.

Create organization API keys

To create an organization API key you will require admin access to your organization (see Roles below for a description). Click the gear icon in the top-right corner, then Organization Settings, then Manage API Keys, then Create API Key. The organization API key is treated as a password: once the window is closed you can no longer retrieve it, so make sure you copy it. We recommend keeping it as Read only unless you specifically need write access.

Using the organization API key

When you authorize an API call with the key, it will only give you access for that specific Organization and all the Projects, Scenes, and Sessions of that Organization.

Organization API keys have the format orgkey-abcdef1234567890. This key should be used as the value of an Authorization header.

For example "Authorization" : "orgkey-abcdef1234567890"

Note: Organization API keys issued before May 2025 do not have the same format. They need to be prefixed with APIKEY:ORGANIZATION instead. For example "Authorization" : "APIKEY:ORGANIZATION abcdef1234567890"

Currently, organization API keys only have granularity to the organization level, if you are interested in more granular control, please contact us.

Content Types

Most requests accept only JSON or do not expect a request body at all. The expected JSON request formats are documented where possible. Endpoints that upload raw files instead expect raw binary data and a content type that accurately reflects the file being uploaded. Similarly, endpoints that serve raw files will serve them with the content type they were uploaded with. All other routes return JSON or do not return with a response body.

Authorization

Each user has one or more roles. There are various scopes a role can have. Note that some roles can be observer roles which are read-only. There are various scopes a role can have. These scopes are a hierarchy; for example if you have Organization-level access, you will also have Project, and Scene level access.

Domain

This is the highest level permission a user can have. This is only available if you have a private label agreement with us. This scope allows access to domain settings.

Organization

The organization scope allows viewing/editing organization settings, such as adding/changing organization members (and their roles), viewing the organization audit log, configuring third-party connections, etc.

Project

Project scope allows viewing and editing project-level settings, and allows access to all scenes. This also covers access to Objectives, ExitPoll, Media Library, etc.

Scene

Allows viewing/editing a scene and its contents. This includes the scenes dynamic objects, sessions, aggregate data, and media.

User

All users have access to their own account, this allows things such as fetching their own information, updating their password, etc.

Additional API Documentation

We now offer comprehensive API documentation, please see our Postman docs.

If you can't find what you are looking for in the above link please contact us.

If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.