Set up Blazing Agents

Create an API key

Create an API key from your tenant's authenticated Blazing Agents administration surface. Copy the complete ba_... token when it is returned: the full token is visible only at creation, and later listings contain only a short display fragment.

An API key is a tenant-scoped bearer credential with access to all of that tenant's Agents. The SDK sends it as Authorization: Bearer <api-key>; it does not represent or authorize an end-user.

Install the TypeScript SDK

Install the SDK and its required AI SDK peer dependency:

npm install @blazing-agents/sdk ai

Create the client

Store the key and API URL in your backend environment, then save this reusable client as client.ts:

import { BlazingAgents } from "@blazing-agents/sdk";

export const client = new BlazingAgents({
  apiKey: process.env.BLAZING_AGENTS_API_KEY!,
  baseUrl: process.env.BLAZING_AGENTS_BASE_URL!,
});

const { agents } = await client.agents.list();
console.log(`Authenticated; found ${agents.length} Agents.`);

Set baseUrl to the API URL for your Blazing Agents environment. You may omit it only when the local API is available at the SDK default, http://localhost:8787.

The client uses the runtime's global fetch. Pass the optional fetch constructor setting only when your runtime or tests need a compatible replacement.

Verify your setup

Run the TypeScript program from your backend. client.agents.list() is non-destructive and returns an object with an agents array; the log should print its current length without an authentication error.

If the read fails, use the Errors reference to identify the returned error code before changing the client configuration.