List Roles

Lists all permissions roles available in the caller's organization, including built-in system roles. System roles such as Admin and Member are always present in every organization and cannot be modified or deleted. Custom roles appear alongside them and can be created, updated, or removed as needed. To inspect or modify a specific role, use [`GET /api/permissions/roles/{id}`](../../../api-reference/permissions/roles/get).

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Headers

X-Polytomic-VersionstringRequired

Response

OK
datalist of objects or null

Errors

401
Unauthorized Error
500
Internal Server Error