Permissions

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}.

get/api/permissions/roles

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    • HTTP bearer
    • or HTTP basic

Headers

X-Polytomic-Versionstring

Response

OK

Example response

{
  "data": [
    {
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "name": "Custom",
      "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
    }
  ]
}

Changes

No recorded changes to this operation across all 51 revisions of this API.