Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Provider

Generate a provisioning token (owner/admin session, provider org only)

Command line

The orl CLI wraps this endpoint:

orl provider provisioning-token create
POST
/v1/orgs/{orgId}/provider/tokens
AuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

In: header

Path Parameters

orgId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Every token lives 24 hours from creation and enrolls any number of nodes in that window; neither is a request input. The node runtime is not a token property; each node detects its own shape at enroll (baremetal becomes qemu, a cloud guest becomes runc). Expired and revoked tokens stay listed for 7 days after creation, then fall out.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/orgs/string/provider/tokens" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "token": "string",  "tokenPrefix": "string",  "name": "string",  "expiresAt": "string",  "warning": "string",  "nodePool": "string"}