API Reference

Base URL

All API requests should be made to:

https://api.nvrse.dev/api/interactive

All endpoints require API key authentication. Include your key in the request headers:

X-API-Key: your_api_key_here

See Authentication for more details.

All responses are JSON unless otherwise specified (e.g., streaming endpoints, audio).

{
  "data": { ... }
}

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "correlationId": "uuid-for-debugging"
}

Code	HTTP Status	Description
`UNAUTHORIZED`	401	Missing or invalid API key
`FORBIDDEN`	403	No permission for this resource
`NOT_FOUND`	404	Resource doesn’t exist
`VALIDATION_ERROR`	400	Invalid request parameters
`INTERNAL_ERROR`	500	Server error

List endpoints support pagination via query parameters:

Parameter	Type	Default	Description
`limit`	integer	20	Max items to return (1-100)
`offset`	integer	0	Number of items to skip

Example:

GET /api/interactive/runs/me?limit=10&offset=20