Getting Started

AGNT is a platform for building AI-powered agent workflows. You bring the logic, we handle the infrastructure — execution, context, communication, observability, and more.

The Platform

AGNT spans 20 products across 7 groups:

• Execution — Run agent workflows, manage chats and tasks
• Context — Memory, knowledge bases, user profiles
• Communication — Channels, notifications, messaging
• Setup — Organizations, certificates, provider configuration
• Observability — Traces, logs, debugging
• Monetization — Usage tracking, billing integration
• Prompts — Prompt management via AGNT Studio

Each product has its own API. They all share the same authentication model and response format.

Quickstart

Four steps to your first API call.

1. Create an Account

Sign up at agnt.ai. You'll get an organization automatically.

2. Create a Certificate

curl -X POST https://api.agnt.ai/certificates \
  -H "Content-Type: application/json"

Save the privateKey from the response. AGNT doesn't store it — if you lose it, create a new certificate.

Note the kid value. You'll need it for signing JWTs.

3. Sign a JWT

Use the private key to sign JWTs locally. Here's a quick example using the jose library in Node.js:

import { SignJWT, importPKCS8 } from "jose";
import fs from "fs";

const privateKey = await importPKCS8(
  fs.readFileSync("./private-key.pem", "utf-8"),
  "RS256"
);

const token = await new SignJWT({ email: "user@example.com" })
  .setProtectedHeader({ alg: "RS256", kid: "your-kid" })
  .setIssuedAt()
  .setExpirationTime("1h")
  .sign(privateKey);

See Authentication for the full details — Management vs. Delegated APIs, payload fields, certificate lifecycle.

4. Make API Calls

Create a chat and send a message:

# Create a chat
curl -X POST https://api.agnt.ai/chats \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My first chat"}'

# Send a message (use the chat ID from the response)
curl -X POST https://api.agnt.ai/chats/CHAT_ID/messages \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello, AGNT."}'

That's it. You're making API calls.

What's Next

• Authentication — Certificate management, JWT structure, auto-provisioning
• Response Format — Standard response shapes, error codes, pagination
• Rate Limits — Rate limiting and concurrency locks
• AGNT Studio — Visual prompt authoring, version control, and deployment for your agent prompts