Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.imarobot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Base URL

https://api.imarobot.ai
All endpoints are versioned under /v1/. The /health endpoint is unversioned.

Authentication

All endpoints except /health and GET /v1/verify/:token require a Bearer token:
Authorization: Bearer sk_live_YOUR_KEY
See Authentication for key types and scopes.

Rate limits

Every response includes rate limit headers:
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4847
X-RateLimit-Reset: 1711234567
PlanVerify endpointAll other endpoints
Unauthenticated100 req/min20 req/min
Free500 req/min60 req/min
Developer5,000 req/min500 req/min
Growth50,000 req/min2,000 req/min
EnterpriseCustomCustom
Exceeded limits return 429 with the standard error schema.

Error format

All errors follow a consistent schema:
{
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "No agent found with the specified ID.",
    "request_id": "req_abc123",
    "docs_url": "https://docs.imarobot.ai/errors/AGENT_NOT_FOUND"
  }
}
See Errors for the full list of error codes.

Health check

GET /health
{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-03-26T18:00:00.000Z"
}
No authentication required. Use this for uptime monitoring and receiver connectivity checks.