Skip to main content
The ax role-bindings commands are currently in ALPHA. The API may change without notice. A one-time warning is emitted on first use.
The ax role-bindings commands let you create, retrieve, update, and delete role bindings on the Arize platform. A role binding assigns a role to a user on a specific resource. Only one binding per user per resource is allowed.

ax role-bindings create

Create a new role binding. Assigns a role to a user on the specified resource. If a binding already exists for the user on the resource, the command exits without error.
ax role-bindings create --user-id <id> --role-id <id> --resource-type <type> --resource-id <id>
OptionDescription
--user-idGlobal ID of the user to bind the role to
--role-idGlobal ID of the role to assign
--resource-typeResource type to bind the role on
--resource-idGlobal ID of the resource to bind the role on
Example:
ax role-bindings create \
  --user-id usr_abc123 \
  --role-id role_xyz789 \
  --resource-type PROJECT \
  --resource-id proj_abc123

ax role-bindings get

Get a role binding by ID.
ax role-bindings get <binding-id>
Example:
ax role-bindings get rb_abc123

ax role-bindings update

Update a role binding by replacing its assigned role.
ax role-bindings update <binding-id> --role-id <id>
OptionDescription
--role-idNew role ID to assign
Example:
ax role-bindings update rb_abc123 --role-id role_new789

ax role-bindings delete

Delete a role binding by ID. This operation is irreversible.
ax role-bindings delete <binding-id> [--force]
OptionDescription
--forceSkip the confirmation prompt
Examples:
ax role-bindings delete rb_abc123
ax role-bindings delete rb_abc123 --force