# Create

Launch stage: Beta

`POST /api/2.1/{parent=knowledge-assistants/*}/examples`

Creates an example for a Knowledge Assistant.

API scopes: knowledge-assistants

## Path parameters

- `parent` (string, optional)
  Parent resource where this example will be created.
   Format: knowledge-assistants/{knowledge_assistant_id}

## Request body

- `example` (object, optional)
  The example to create under the parent Knowledge Assistant.
  - `name` (string, optional)
    Full resource name:
     knowledge-assistants/{knowledge_assistant_id}/examples/{example_id}
  - `question` (string, optional)
    The example question.
  - `guidelines` (array of string, optional)
    Guidelines for answering the question. Optional — examples may be created
     with just a question; the front-end form does not require guidelines.
  - `example_id` (string, optional)
    The universally unique identifier (UUID) of the example.
  - `create_time` (string, optional)
    Timestamp when this example was created.
  - `update_time` (string, optional)
    Timestamp when this example was last updated.

## Returns

Returns the Example object.

## Response

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