Skip to main content

API Authentication

VADRR's REST API uses API key authentication. All API endpoints require a valid API key.

Getting Your API Key​

  1. Log in to VADRR.
  2. Click your username → Profile.
  3. Open the Storage tab.
  4. Copy your API key. Click Regenerate to issue a new one (this invalidates the old key).

Using the API Key​

Pass the API key in one of two ways:

Authorization: Bearer YOUR_API_KEY

Query Parameter​

GET /api/v3/projects?api_key=YOUR_API_KEY

Base URL​

https://vadrr.org/api/v3/

(Replace v3 with the appropriate version for your endpoint — see below.)

Response Format​

All API responses are JSON. Successful responses return HTTP 200 or 201. Errors return 4xx with a JSON body:

{
  "error": "Unauthorized"
}

Rate Limiting​

The API is rate-limited per IP. Sustained high-volume requests may be throttled. Contact your VADRR administrator if you need elevated limits.