# Update

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, optional)
  The resource name of the example to update.
   Format: supervisor-agents/{supervisor_agent_id}/examples/{example_id}

## Query parameters

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

## Request body

- `example` (object, optional)
  - `name` (string, optional)
    Full resource name:
     supervisor-agents/{supervisor_agent_id}/examples/{example_id}
  - `question` (string, optional)
    The example question.
  - `guidelines` (array of string, optional)
    Guidelines for answering the question.
  - `example_id` (string, optional)
    The universally unique identifier (UUID) of the example.

## Returns

Returns the Example object.

## Response

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