---
title: "One expert with its whole instructions"
method: GET
path: "/api/v1/experts/{id}"
tags: ["Experts"]
---

# One expert with its whole instructions

`GET /api/v1/experts/{id}`

## Request

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

Read one of the user's experts in full: its name and its standing instructions as Markdown, the way the user wrote them in Roma. Use it when the user names an expert for the work at hand ("use my Content Editor on this"), asks what one of them covers, or before updating one. By id (from list_experts or get_context) or by its exact name; a name that is none of theirs is not found.

## Path parameters

- `id` string, required

## Response `200`

The tool's result.

- object
  - `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.
  - `instructions` string, required: The whole standing instructions, as Markdown.

## 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)