---
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.

## Changes

- **2020-05-14** `63bec9d0050f` — 1 info
  - added the new optional `query` request parameter `enableNestedChildren`

[Change history](https://skmtc.dev/azure/apis/luis-authoring-client/changes/apps/:appId/versions/:versionId/example/post.md)

---

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