---
title: "POST /apps/{appId}/versions/{versionId}/example"
method: POST
path: "/apps/{appId}/versions/{versionId}/example"
---

# POST /apps/{appId}/versions/{versionId}/example

`POST /apps/{appId}/versions/{versionId}/example`

Adds a labeled example utterance in a version of the application.

## Path parameters

- `appId` string, uuid, required
- `versionId` string, required

## Query parameters

- `enableNestedChildren` boolean

## Request body

- ExampleLabelObject — A labeled example utterance.
  - `text` string — The example utterance.
  - `entityLabels` EntityLabelObject[] — The identified entities within the example utterance.
    - `entityName` string, required — The entity type.
    - `startCharIndex` integer, required — The index within the utterance where the extracted entity starts.
    - `endCharIndex` integer, required — The index within the utterance where the extracted entity ends.
    - `role` string — The role the entity plays in the utterance.
    - `children` EntityLabelObject[] — The identified entities within the example utterance.
  - `intentName` string — The identified intent representing the example utterance.

## Response `201`

The ID of the created example utterance.

- LabelExampleResponse — Response when adding a labeled example utterance.
  - `UtteranceText` string — The example utterance.
  - `ExampleId` integer — The newly created example ID.

## Other responses

- `default` — Error Response.

---

[API](https://skmtc.net/azure/apis/luis-authoring-client.md) · [All operations](https://skmtc.net/azure/apis/luis-authoring-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/luis-authoring-client/versions/a26a0f7e5a37/schema)