Experts

Rename an expert or replace its instructions

Update one of the user's experts: its name, its instructions, or both. instructions replaces the WHOLE body: read it with get_expert first and send the whole text with the change in it, a line that contradicts an existing one replacing that line rather than sitting beside it. A rename to a name the user already has is refused. The previous body stays in the expert's version history (list_versions, restore_version). Use it when the user says an expert missed something, should work differently, or should be called something else.

patch/api/v1/experts/{id}

Request

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

Path parameters

idstring required

The expert's id (from list_experts, get_expert or get_context).

Request body

namestring nullable

A new name. Omit, or pass null, to keep it.

instructionsstring nullable

The whole standing instructions, as Markdown, replacing the body. Omit, or pass null, to keep it.

baseUpdatedAtstring nullable

The updatedAt get_expert returned; when the expert changed since, the write is refused and the body is read again.

Response

The tool's result.

idstring required
namestring required
firstLinestring required

The opening line of its instructions.

updatedAtstring required
webUrlstring required

The expert's page in Roma on the web.

changedstring[] required

Which of name and instructions changed.

Changes

No recorded changes to this operation across all 1 revision of this API.