API Reference

Base URL: https://api.auteryn.ai

The Auteryn REST API lets you integrate AI agents directly into your applications.

Endpoints

POST /api/run

Run an agent — streaming SSE or synchronous JSON. Reference →

GET/POST /api/tasks

List, get, and delete tasks and runs. Reference →

GET /api/messages

Retrieve message history for a task. Reference →

GET/POST/DELETE /api/memory

Read and manage agent memory entries. Reference →

POST /api/v1/widget/run

Widget gateway for embedded chat. Reference →

All requests require:

Authorization: Bearer afk_your_api_key
X-Agent-Id: your-agent-id
Content-Type: application/json

See Authentication → for full details.

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

Status	Code	Meaning
`401`	`unauthorized`	Missing or invalid API key
`402`	`insufficient_credits`	Not enough credits to run
`403`	`forbidden`	Key valid but no access to this resource
`404`	`agent_not_found`	Agent ID not found
`429`	`rate_limited`	Too many requests
`500`	`internal_error`	Unexpected server error