Skip to main content
The Revex API lets your own tools create scans and read scan history without opening the panel. A common use is a Discord bot that creates a scan and posts the PIN in a ticket.

Base URL

Authentication

Every request needs a developer key in the Authorization header.
1

Create a key

Open the panel, go to Developer keys and create a key. Give it a name (1-40 characters).
2

Copy it once

The full key is shown only once, when you create it. Only a hash is stored, so a lost key cannot be recovered. Create a new one instead.
3

Use it in requests

Send it as a Bearer token. Keys start with rvx_.
Keep keys secret and never put them in client-side code. If a key leaks, revoke it in the panel right away.

Key rules

  • Keys start with rvx_ followed by 43 characters.
  • An organization can have at most 5 active keys.
  • A key stops working if the person who created it leaves the team.
  • Requests use the key owner’s organization and permissions. No cookies or CSRF tokens are needed.

Rate limits

Exceeding a limit returns 429 RATE_LIMITED. Wait a minute and retry.

Endpoints

Create a scan

POST /api/v1/scans

List scans

GET /api/v1/scans
See Errors for all error codes.