---
title: "List roles"
method: GET
path: "/org/roles"
tags: ["Roles"]
---

# List roles

`GET /org/roles`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/roles`
- Auth: API key in header `X-API-Key`

Returns the roles defined for your organization, including built-in system roles.

## Response `200`

Your organization's roles.

- RoleResponse[]
  - `role_id` string, uuid, required
  - `org_id` string, uuid, required
  - `name` string, required: The raw role name (e.g. `admin`, `viewer`, `collaborator`).
  - `description` string: Role description, when set.
  - `is_system` boolean, required: Whether this is a built-in system role (not editable).
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time: When the role was deleted; absent while it is active.

## Other responses

- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)