# Update an example in a Supervisor Agent

Launch stage: Beta

`PATCH /api/2.1/{name=supervisor-agents/*/examples/*}`

Updates an example in a Supervisor Agent.

API scopes: supervisor-agents

## Path parameters

- `name` (string, required)
  The resource name of the example to update.
   Format: supervisor-agents/{supervisor_agent_id}/examples/{example_id}

## Query parameters

- `update_mask` (string, required)
  Comma-delimited list of fields to update on the example.
   Allowed values: `question`, `guidelines`.
   Examples:
   - `question`
   - `question,guidelines`

## Request body

- `name` (string, optional, ID, Immutable)
  Full resource name:
   supervisor-agents/{supervisor_agent_id}/examples/{example_id}
- `question` (string, required)
  The example question.
- `guidelines` (array of string, required)
  Guidelines for answering the question.

## Returns

Returns the Example object.

## Response

```json
{
  "name": "string",
  "question": "string",
  "guidelines": [
    "string"
  ],
  "example_id": "string"
}
```