API Quickstart

The AGNT API is the runtime on your own machine:

http://localhost:3333/api/

Everything is here — agents, workflows, goals, tools, skills, memory, schedules, receipts. There is no cloud API to learn: your code talks to your runtime.

Authentication in ten lines

Requests carry a JWT bearer token:

Authorization: Bearer <your-jwt-token>

Where the token lives depends on where your code runs — a widget uses the agnt SDK, the frontend reads its session, and orchestrator tools get process.env.AGNT_AUTH_TOKEN injected. The three contexts, with copy-paste patterns for each, are on the Authentication page. Many local endpoints also work unauthenticated on localhost.

Your first call

curl http://localhost:3333/api/agents/health

const res = await fetch('http://localhost:3333/api/agents/', {
  headers: { Authorization: 'Bearer ' + token },
});
const agents = await res.json();

Where everything is

Core: Agents & Orchestration · Workflows · Goals & Autonomy · Tools · Skills

State: Memory & Insights · Ledger & Wallets · Content & Artifacts · Schedules & Listeners

Platform: Models & Providers · Plugins & MCP · Execution & Streaming · FileSystem · Workspace & UI · Experiments & Contracts · Users & System

Shared: Conventions — errors, rate limits, pagination, SSE and WebSockets, once.