---
title: "List Team Roles"
method: GET
path: "/api/v1/team/roles"
tags: ["team"]
---

# List Team Roles

`GET /api/v1/team/roles`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/team/roles`
- Auth: none declared

This organization's roles, Admin first, and what each grants.

Permissions come back in enum declaration order, not frozenset order, so
the response is stable.

## Response `200`

Successful Response

- TenantRoleRead[]
  - `id` string, uuid, required
  - `kind` 'ADMIN' | 'MEMBER' | 'CUSTOM', required: A role's kind. Every organization has one ADMIN and one MEMBER role; CUSTOM roles are ones an organization adds (milestone G).
  - `name` string, required
  - `description` string, required
  - `permissions` TenantPermission[], required

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-15** `b296c001373b`: 1 breaking, 4 info
  - removed the required property `items/role` from the response with the `200` status
  - added the required property `items/description` to the response with the `200` status
  - added the required property `items/id` to the response with the `200` status
  - added the required property `items/kind` to the response with the `200` status
  - …1 more
- **2026-10-15** `a9cebb28e243`: 11 warning
  - added the new `ALLOW_AI_AUTONOMY` enum value to the `items/permissions/items/` response property for the response status `200`
  - added the new `MANAGE_ACTIONS` enum value to the `items/permissions/items/` response property for the response status `200`
  - added the new `MANAGE_BOOKINGS` enum value to the `items/permissions/items/` response property for the response status `200`
  - added the new `MANAGE_CAMPAIGNS` enum value to the `items/permissions/items/` response property for the response status `200`
  - …7 more
- **2026-10-14** `94fc7fe82074`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/team/roles/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4d9d38769a75?raw)