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

orl roles create

Create a custom role (needs `orl auth login`), part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl roles create --name <name> --permissions <permissions>

Creates a custom role from a set of permissions plus optional model, endpoint and network conditions, and returns it. A role cannot grant more than you hold. Requires a signed-in session. A role that grants more than its creator holds is refused with 403 ESCALATION_REFUSED, which names the first missing permission.

Flags

FlagTypeRequired
--descriptionstringno
--endpoints[]stringno
--ip-ranges[]stringno
--models[]stringno
--namestringyes
--permissions[]stringyes
--bodystringnoa JSON object of request body fields, merged under any of this command's own flags that are also set, e.g. {"key":"value"}
--body-filestringnoread the --body JSON object from a file (- for stdin)

This wraps the createRole API operation.

On this page