Get Roles

GET

///v1/parameter/role

Return a list of roles. Default: all. With managed_only=true: only those with managed devices.

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

Query parameters

managed_onlybooleanOptionalDefaults to false

Limit to roles with managed devices

Response

Successful Response

idstring

namestring

Errors

422

Unprocessable Entity Error

1	[
2	{
3	"id": "role-001",
4	"name": "Administrator"
5	},
6	{
7	"id": "role-002",
8	"name": "Developer"
9	},
10	{
11	"id": "role-003",
12	"name": "Operator"
13	},
14	{
15	"id": "role-004",
16	"name": "Viewer"
17	}
18	]