---
title: "The user's experts, each with the opening line of its instructions"
method: GET
path: "/api/v1/experts"
tags: ["Experts"]
---

# The user's experts, each with the opening line of its instructions

`GET /api/v1/experts`

## Request

- Base URL: `https://api.roma.app`
- URL: `https://api.roma.app/api/v1/experts`
- Auth: HTTP bearer

List the user's experts: each a named body of standing instructions they wrote in Roma for a kind of work (an editor, a reviewer, a coach), private to them. Returns every expert's id, name and the opening line of its instructions. Use it when the user asks which experts they have, names one, or asks for work done the way one of their experts does it; get_expert reads one in full.

## Response `200`

The tool's result.

- object
  - `count` number, required
  - `experts` object[], required
    - `id` string, required
    - `name` string, required
    - `firstLine` string, required: The opening line of its instructions.
    - `updatedAt` string, required
    - `webUrl` string, required: The expert's page in Roma on the web.

## Other responses

- `400`: The request was understood and refused; the error says what to change.
- `401`: No usable bearer token.
- `404`: No such item for this account.
- `405`: The path exists but not with this method; Allow lists the ones that work.
- `429`: Over the rate limit; wait for Retry-After.

---

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