API Reference

Authentication

Get a quick grasp on how authentication works with audio.

Generally, authentication is handled over sessions.

Sessions expire after 1 day and contain a key pair consisting of a session_token and a refresh_token.

The session_token is used to authenticate and identify requests. All endpoints for logged in actions require the session_token to be set as the Authorization header across the API.

The refresh_token should only be used to generate new, authenticated sessions, so the client can stay logged in, even over multiple sessions.

Key pair sources

You can get a valid key pair of tokens by the following means:

As you can see, once a session is expired, the client needs to start a new authentication flow by logging in with username and password. Make sure to refresh your token key pair early to guarantee a seamless user experience.