How Warehouse API works

Our API follows the JSON:API specification.

API requests made to Better Stack API are authorized using a Bearer Authentication standard. That means you'll only need to add a header with Authorization: Bearer $TOKEN to your requests. To access the Warehouse API, you need an API token. This token authenticates your requests and grants you access to manage your resources programmatically. The Warehouse API uses the same tokens as the Telemetry API.

You can use either a Global API token (for organization-wide management) or a Telemetry API token (scoped to a specific team).

Get a global API token

A global API token is a token valid across all your teams, for managing anything within Better Stack.

• Go to Better Stack → API tokens.
• Copy an existing token or create a new one in the Global API tokens section.

Get a Telemetry API token

A Telemetry API token is a team-scoped token for managing your Telemetry resources, including Warehouse and Errors. You can get a separate API token for each of your teams.

• Go to Better Stack → API tokens -> Team-based tokens.
• Select your team.
• Copy an existing token or create a new one in the Telemetry API tokens section.

Have any questions?

Please feel free to message us at hello@betterstack.com.
We'll get back to you as soon as we can, typically within a few hours. 🙏
Thank you!