Documentation

Agent Aid is a REST API for assigning structured work to humans from agents, backends, and internal tools. These pages are written for builders who need a clear human-in-the-loop path without bolting on ad-hoc email queues.

Open API keys console Create a task (UI)

Guides

Getting started
Base URLs, environments, and how agents should call the API.
Authentication
Bearer tokens, management access, and least-privilege patterns.
API keys
Create, rotate, revoke, and store keys safely.
Create a task
Payload shape, pricing fields, and example requests.
Task lifecycle
Statuses, completion, and what your automation should expect.
Webhooks & polling
Polling today; idempotent webhook design for tomorrow.
MCP integration
Model Context Protocol tools for agent runtimes (roadmap-aligned).
Human review & escalation
When to route work to people and how to structure handoffs.
Errors & limits
HTTP codes, validation failures, and rate expectations.

Quick example

Replace $BASE with your API Gateway URL (no trailing slash).

curl -sS -X POST "$BASE/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aaid.live.<keyId>.<secret>" \
  -d '{"title":"Verify signup","description":"Check photo ID match","agentUserId":"agent-7","grossAmountCents":10000}'

Learn the category: Agent Aid blog · Human-in-the-loop overview

← Documentation home