API Reference

DraftLast reviewed 2026-06-23

List available roles and their scopes

GET 
/api/v1/config/roles

Returns every FUNCTIONAL group (former role) from auth.groups together with the scope identifiers (auth.group_scopes) each grants (DS T12, #712). Manage these via POST/DELETE /api/v1/admin/functional-groups/{id}/scopes.

Responses

200

Role list returned

401

Authentication required

403

Insufficient scope — requires config:read