Agento API

One API for agents that do real work.

Create agents, start runs, handle approvals, and stream every step, from any language that can make an HTTP request.

$npm i @agento/sdk

agent.ts

import { Agento } from '@agento/sdk';

const agento = new Agento({ apiKey: process.env.AGENTO_KEY });

const agent = await agento.agents.create({
  name: 'Lead researcher',
  instructions: 'Score new leads against our ICP and explain why.',
  tools: ['hubspot.read', 'gmail.draft'],
  approvals: ['gmail.send'],
});

await agento.runs.create({ agent: agent.id });

run_8f3a2c · Lead researcher

Read 48 new leads from HubSpot1.2s
Researched companies and scored fit38s
Drafted 12 intros in Gmail9s
Waiting for approval: send 12 emailsnow

Quickstart

Your first run in three lines

Create a key in Settings → API keys, then start a run for any agent.

curl -X POST https://api.example.com/v1/runs \
  -H "Authorization: Bearer $AGENTO_KEY" \
  -d '{ "agent": "lead-researcher" }'

import { Agento } from '@agento/sdk';

const agento = new Agento({ apiKey: process.env.AGENTO_KEY });
const run = await agento.runs.create({ agent: 'lead-researcher' });

from agento import Agento

agento = Agento(api_key=os.environ['AGENTO_KEY'])
run = agento.runs.create(agent='lead-researcher')

SDKs

API

Everything an agent needs, one API

Durable runs, scoped tools, and human approvals are primitives, not projects.

Agents as code
Define instructions, tools, and limits in TypeScript or Python, and version them with your app.
agents.create()
Durable runs
Every step is checkpointed, retried, and resumable, even across deploys.
runs.create()
Approvals
Mark any tool call as approval-required and resume when a person says yes.
approvals: ['gmail.send']
Webhooks
Get signed events for every step, approval, and result.
run.step.completed
Scoped keys
Keys per environment and per agent, with record-level permissions.
scope: agents:read
Audit log API
Stream every action to your SIEM or data warehouse.
GET /v1/audit

Authentication

Secure by default

Every request uses a bearer key scoped to a workspace, an environment, and optionally a set of agents.

Scoped keysSeparate keys per environment, each limited to the agents it needs.
Signed webhooksVerify every event with an HMAC signature.
Audit logEvery API call is logged with the key that made it.

Rate limits

Plan	Requests / min	Concurrent runs
Starter	60	5
Pro	600	50
Business	3,000	250
Enterprise	Custom	Custom

Full API referenceEvery endpoint, parameter, and event, with examples.Open the docs

Build your first agent in code

Free for 14 days. Bring your own model on Enterprise.

Get an API key Talk to an engineer

One API for agents that do real work.

Agents as code

Durable runs

Approvals

Webhooks

Scoped keys

Audit log API

Secure by default

Build your first agent in code