Skip to main content

​
Base URL

https://app.orova.ai/api
All API endpoints are prefixed with /api.

​
Authentication

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.

​
Response format

All responses are JSON. Successful responses return the data directly. Errors return: 
{
  "statusCode": 400,
  "message": "Error description",
  "error": "Bad Request"
}

​
Common status codes

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

​
Pagination

List endpoints support pagination:
ParameterDefaultDescription
page1Page number
limit10Items per page (max varies by endpoint)

​
Rate limits

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