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

# List roles

`GET /roles`

Get a list of all available roles with optional provider filtering and search

## Query parameters

- `provider` string
- `q` string
- `limit` integer

## Response `200`

List of roles

- ModelsRolesResponse
  - `roles` object
  - `version` string

## Other responses

- `401` — Unauthorized

## Changes

- **2026-02-06** `acda3d3bb85e` — 2 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `q`
- **2025-11-03** `6a5321fd619a` — 2 warning
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `q`

[Change history](https://skmtc.dev/thand-io/apis/thand-agent-api/changes/roles/get.md)

---

[API](https://skmtc.dev/thand-io/apis/thand-agent-api.md) · [All operations](https://skmtc.dev/thand-io/apis/thand-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thand-io/thand-agent-api/revisions/acda3d3bb85e/schema)