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

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

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

Adds a batch of labeled example utterances to a version of the application.

## Path parameters

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

## Query parameters

- `enableNestedChildren` boolean

## Request body

- ExampleLabelObject[] — Object model for adding a batch of labeled examples.
  - `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`

A string array determining which labeled example utterances were added successfully.

- BatchLabelExample[] — Response when adding a batch of labeled example utterances.
  - `value` LabelExampleResponse — Response when adding a labeled example utterance.
    - `UtteranceText` string — The example utterance.
    - `ExampleId` integer — The newly created example ID.
  - `hasError` boolean
  - `error` OperationStatus — Response of an Operation status.
    - `code` 'Failed' | 'FAILED' | 'Success' — Status Code.
    - `message` string — Status details.

## Other responses

- `207` — Indicates that the request was partially successful. The response contains a string array indicating the status of each of the added labeled example utterances.
- `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/revisions/a26a0f7e5a37/schema)