SDK Installation

Install the Aeontel SDK and construct an Aeontel client.

Install

pnpm add @aeontel/sdk
# or
npm install @aeontel/sdk
# or
yarn add @aeontel/sdk

The package is pure TypeScript, works in Node 22+, modern browsers, Bun, Deno, and Cloudflare Workers. It has zero runtime dependencies.

Construct a client

import Aeontel from "@aeontel/sdk";

const client = new Aeontel("sec_...");

apiKey is positional, not nested in options. Pass null to use cookie auth (see Authentication). If omitted, the SDK falls back to the AEONTEL_API_KEY environment variable.

Options

const client = new Aeontel("sec_...", {
  baseURL: "https://api.aeontel.com", // default
  timeout: 30_000, // ms, default
  maxRetries: 2, // retries 429 / 5xx, default
  workspaceId: "wsp_...", // auto-filled on every call
  headers: { "x-caller": "my-app" }, // sent with every request
});

workspaceId is particularly useful — set it once and every request that takes a workspaceId body field or workspace_id query param is filled automatically. Explicit per-call values always win.

From a Cloudflare Worker

If your Worker has the API bound via services in wrangler.jsonc, pass the binding directly and requests go through binding.fetch() without hitting the public internet.

import Aeontel from "@aeontel/sdk";

export default {
  async fetch(request: Request, env: Env) {
    const client = new Aeontel(null, { binding: env.AEONTEL_API });
    const agents = await client.agents.list({ workspace_id: "wsp_..." });
    return Response.json(agents.data);
  },
};