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

orl api

Call a control-plane or inference-host path with the current credentials, part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl api <method> <path> [flags]

Send one authenticated request to the control plane, or (automatically for a path the spec serves from there: /v1/chat/completions, /v1/messages, /v1/embeddings, /v1/decisions, /v1/batches*, /v1/files*, or with --inference) the inference host. Intended for platform-admin routes that have no generated command (/v1/admin/orgs, /v1/admin/catalog, ...) and for a brand-new inference route ahead of its own command. Uses the same bearer as every other orl command: OPENRELAY_API_KEY, --api-key, or a stored login (including ADMIN_API_TOKEN); the key only ever reaches the one host the call resolved to.

Flags

FlagTypeRequired
--bodystringnoJSON request body
--body-filestringnoread the JSON request body from a file (- for stdin)
--inferenceboolnocall the inference host even for a path this orl does not already know belongs there

On this page