List all roles available for an organization, including global and organization-specific roles.
List all roles available for the organization. System roles are returned first in a defined order (Owner, Admin, Member, Department Manager, Knowledge Manager, Billing Manager), followed by custom roles alphabetically. Hidden internal roles are excluded from results.
organization_id string required
Organization ID (org_ prefixed string).
include_global boolean optional · Defaults to true
Whether to include global (system-wide) roles in the response alongside organization-specific roles.
An array of role objects. Each role includes id, name, description, permissions, is_base_role, is_custom, is_system_role, capabilities, member_count, knowledge_slice_ids, organization_id, and created_at.
- Bash
- Python
- Python
- JavaScript
curl "https://api.aitronos.com/v1/organizations/org_abc123/roles?include_global=true" \
-H "Authorization: Bearer $ACCESS_TOKEN"