What the ReactVision Spatial API covers, how to authenticate, and where to find errors, limits and changes.
The ReactVision Spatial API serves a ReactVision Editor team's cloud anchors, geospatial anchors, files, Editor scenes and projects, scene API requests, AI generation, co-location rooms and Advanced VPS locations and scans, and mints user tokens. ViroReact calls it for you once you set rvApiKey; this reference is for calling it directly, usually from your own backend.
Base URL
Every operation is under:
https://platform.reactvision.xyz/functions/v1
Authentication
Send an API key in the x-api-key header:
curl https://platform.reactvision.xyz/functions/v1/projects/{project_id} \
-H "x-api-key: rv_secret_..."
| Key | Prefix | Where it goes |
|---|---|---|
| Client key | rv_client_ | Inside your app. Bound to one project. |
| Secret key | rv_secret_ | On your backend. Never in an app you publish. |
| Legacy key | rv_live_ | Keys made before Editor 1.5.0. They keep working and are being converted. |
| User token | rv_ut_ | Minted by your backend for one signed-in app user, sent as Authorization: Bearer <token>. Lasts up to one hour. |
Each operation's description starts with the key types it accepts, then its scope. Any other key type is refused with 403 API_KEY_TYPE_NOT_ALLOWED, and a secret key created without the operation's scope with 403 API_KEY_SCOPE_NOT_ALLOWED. Which key to use where, project binding and legacy keys are explained in Authentication, Client Keys and Secret Keys. User tokens (rv_ut_), minted with Mint a user token, are accepted by the co-location room operations and the Advanced VPS operations; every other operation refuses them with 401 AUTH_ERROR. Scopes are explained in Authentication.
Responses and errors
Every response is JSON and carries meta.request_id, except a successful Advanced VPS response, which is the documented shape alone; quote it when you contact support. An error carries error.code: branch on the code, not the message. See Errors.
Limits
Monthly quotas, compute billing, search bounds and rate limits are on Limits.
No test mode
Every call acts on your team's live data and counts toward its quotas.
Changes
Changes to the API are announced in the Changelog.