List roles

GET 
/roles

The roles defined in this account, for use as role_id when creating or updating an agent.

Read-only. Roles decide what a person can reach in the console, and editing that matrix from a machine credential is the kind of privilege change that should leave a human's fingerprints on it.

Responses

200

Roles returned.

Response Headers

X-Request-Id

Correlation id for this request. Quote it when reporting a problem.

401

No token, an expired token, or a credential that has been revoked.

Response Headers

X-Request-Id

Correlation id for this request. Quote it when reporting a problem.

403

Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).

Response Headers

X-Request-Id

Correlation id for this request. Quote it when reporting a problem.