APIs

Introduction

Blaze APIs are the request-response layer for the parts of the platform you want to read, shape, or automate. Start with https://api.blaze.stream, choose whether the request belongs to a user access token or an app access token, then follow the endpoint card for scopes, parameters, and response shape. Every https://api.blaze.stream/v1 request must include the Client ID header: client-id.

Base URLhttps://api.blaze.streamAll REST paths in this section are mounted here; every /v1 request requires client-id.

The API loop

Treat every request as a small contract: token context, permission, resource, and response. Once those four pieces are clear, the reference pages become much faster to scan.

Pick the token context

Use user tokens for user-approved actions and app tokens for server-to-server reads where the endpoint accepts a target id.

Check the scope

Endpoint cards list the scopes required for each accepted authorization type.

Choose the resource

Channels cover stream and audience state; Users cover identity, stats, subscriptions, and profile updates; Chat covers message create and delete actions; Categories cover browseable taxonomy; Moderation covers ban, remove-ban, and mute actions.

Follow the card

Each card keeps method, URL, auth options, parameters, examples, and response shape in one place.

Request shape

Most API calls share the same skeleton: method, versioned path, Bearer token, Client ID header, JSON accept header, and a response your UI or backend can trust.

GET/v1/users/profile
Authorization: Bearer YOUR_ACCESS_TOKEN
client-id: YOUR_CLIENT_ID
Accept: application/json

200 OK -> application/json