REST API

v2.1

Full programmatic access to VRSJO resources over HTTPS. All responses are JSON.

Quick Start

curl -X GET \
  -H "Authorization: Bearer TOKEN" \
  -H "Accept: application/json" \
  https://api.VRSJO.io/v2/devices

Authentication

All API requests require a Bearer token in the Authorization header. Generate tokens from the VRSJO Admin under Settings → API Keys. Tokens are scoped to roles and expire after 90 days by default.

Endpoints Overview

Method	Path	Description
`GET`	`/v2/devices`	List all devices
`GET`	`/v2/devices/:id`	Get device by ID
`POST`	`/v2/devices`	Create a device
`PATCH`	`/v2/devices/:id`	Update a device
`DELETE`	`/v2/devices/:id`	Delete a device

Rate Limits

The API enforces a default rate limit of 1,000 requests per minute per token. Burst allowance is 200 requests. When exceeded, the API returns 429 Too Many Requests with aRetry-After header indicating when you may resume.

Error Codes

Code	Meaning
`400`	Bad Request — invalid parameters
`401`	Unauthorized — missing or invalid token
`403`	Forbidden — insufficient permissions
`404`	Not Found — resource does not exist
`429`	Too Many Requests — rate limit exceeded
`500`	Internal Server Error

Home