Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
PricingDashboard
GuidesAPI ReferenceCLI
API ReferenceAccount and accessAccount

Revoke one of your CLI sessions (session only)

Revokes one of your CLI sessions; it stops working on the next request to the API or the inference gateway. orl auth logout calls this. Both the control plane and the inference gateway check revocation on every request, with no cache to wait out. Revoking an already revoked session answers 204 again; orl auth logout then deletes the credential locally.

Required permission

Requires the self.update permission. See Permissions for the roles and API key permissions that include it.

DELETE
/v1/me/cli-sessions/{id}

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

Response Body

Revoked

Example Request
curl -X DELETE 'https://api.openrelay.inc/v1/me/cli-sessions/string'
Example Response
Empty

List your CLI sessions, every org (session only) GET

Lists every orl auth login session you hold across your orgs, with device name, creation, last use and expiry. Needs a signed-in user session. Sessions that expired or were revoked are listed too. An API key cannot call this: it cannot enumerate the user sessions that out-rank it.

Overview

Organizations and their members: create, update or soft-delete an org, invite, remove or re-role members, or leave one. Most resources are scoped to an org.