API Reference

Every agent gets a REST API endpoint. Call your agents from any app, webhook, or automation.

Base URL

https://autoai.dev/api

Endpoints

POST/api/agents/{id}/run

Execute an agent with the given input. Returns the agent's response, token usage, and tool calls.

GET/api/agents/{id}

Retrieve an agent's configuration including name, model, system prompt, and tools.

GET/api/agents/{id}/runs

List recent runs for an agent with input, output, token count, and latency.

POST/api/agents

Create a new agent with a name, system prompt, model, and tool configuration.

PATCH/api/agents/{id}

Update an existing agent's configuration, model, or tools.

DELETE/api/agents/{id}

Delete an agent and all associated run history.

Authentication

All API requests require a Bearer token. Generate your API key from the Dashboard > Settings page. Include it in the Authorization header of every request.

Webhooks

Configure webhooks to receive real-time notifications when agent runs complete. Webhooks send a POST request to your URL with the run result, including output, token usage, and status.

Rate Limits

Free tier: 50 runs/month, 10 requests/minute. Pro tier: unlimited runs, 60 requests/minute. Enterprise: custom limits. Rate limit headers are included in every response.

Example Request

curl -X POST https://autoai.dev/api/agents/{id}/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Summarize the latest tech news"}'

Back to Documentation