API Overview

Base URL

https://app.orova.ai/api

All API endpoints are prefixed with /api.

All API requests require an API key in the x-api-key header. Generate one from the Orova dashboard.

curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"

See Authentication for details.

All responses are JSON. Successful responses return the data directly. Errors return:

{
  "statusCode": 400,
  "message": "Error description",
  "error": "Bad Request"
}

Code	Description
`200`	Success
`201`	Created
`400`	Bad request — check your parameters
`401`	Unauthorized — invalid or missing API key
`402`	Payment required — insufficient credits
`403`	Forbidden — no access to this resource
`404`	Not found
`500`	Server error

List endpoints support pagination:

Parameter	Default	Description
`page`	`1`	Page number
`limit`	`10`	Items per page (max varies by endpoint)

API requests are not currently rate-limited, but we recommend keeping requests under 100/minute per API key.