Skip to content
/
List roles
Last updated

List roles

List all roles available for an organization, including both global and organization-specific roles.

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/roles

Path parameters

  • organization_id string Required
    • Organization ID (org_ prefixed string)

Query parameters

  • include_global boolean Optional
    • Include global roles in the response
    • Default: true

Returns

Array of Role objects.

Bash
curl "https://api.aitronos.com/v1/organizations/org_abc123/roles" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

[
  {
    "id": "role_member",
    "name": "Member",
    "description": "Standard member with basic access",
    "permissions": {},
    "is_base_role": true,
    "is_custom": false,
    "organization_id": null
  },
  {
    "id": "role_admin",
    "name": "Admin",
    "description": "Administrator with full access",
    "permissions": {},
    "is_base_role": true,
    "is_custom": false,
    "organization_id": null
  },
  {
    "id": "role_owner",
    "name": "Owner",
    "description": "Organization owner with complete control",
    "permissions": {},
    "is_base_role": true,
    "is_custom": false,
    "organization_id": null
  }
]

Role object

{
  "id": "role_abc123",
  "name": "Admin",
  "description": "Administrator with full access",
  "permissions": {},
  "is_base_role": true,
  "is_custom": false,
  "organization_id": null
}
Previous page
Next page