**Source URL:** https://limited.veevavault.dev/regulatory/vault-api/api-reference/24.2/documents/document-annotations/add-annotation-replies.md

# Add Annotation Replies



Create up to 500 annotation replies.

<Endpoint path="/api/{version}/objects/documents/annotations/replies/batch" method="POST"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `text/csv` |
| `Content-Type` | `application/json` |
</FieldTable>

## Body Parameters {#body-parameters}

Prepare a JSON-formatted list of annotation reply objects. Each object must contain the `id__sys`, `document_version_id__sys`, and the annotation field(s) to be set, and a `placemark` object containing the following:

<FieldTable>
| Placemark Field | Description |
| --- | --- |
| `type__sys` | The annotation type. This must always be `reply__sys`. |
| `reply_parent__sys` | The ID of the parent annotation. |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '[
   {
       "document_version_id__sys": "1_0_1",
       "type__sys": "reply__sys",
       "comment__sys": "first reply from the api",
       "placemark": {
           "type__sys": "reply__sys",
           "reply_parent__sys": "54"
       }
   },
   {
       "document_version_id__sys": "1_0_1",
       "type__sys": "reply__sys",
       "color__sys": "green_light__sys",
       "comment__sys": "first reply from the api",
       "placemark": {
           "type__sys": "reply__sys",
           "reply_parent__sys": "55"
       }
   },
   {
       "document_version_id__sys": "1_0_1",
       "type__sys": "reply__sys",
       "comment__sys": "second reply from the api",
       "placemark": {
           "type__sys": "reply__sys",
           "reply_parent__sys": "54"
       }
   }
]'
https://myvault.veevavault.com/api/v24.2/objects/documents/annotations/replies/batch \

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS",
            "document_version_id__sys": "1_0_1",
            "global_version_id__sys": "123456_1_1",
            "id__sys": "60"
        },
        {
            "responseStatus": "SUCCESS",
            "document_version_id__sys": "1_0_1",
            "global_version_id__sys": "123456_1_1",
            "id__sys": "62"
        },
        {
            "responseStatus": "SUCCESS",
            "document_version_id__sys": "1_0_1",
            "global_version_id__sys": "123456_1_1",
            "id__sys": "61"
        }
    ]
}

```
</CodeExample>

## Response Details {#response-details}

On SUCCESS, the response includes the document version ID, global version ID, and ID and version of each successfully created reply. See [Create Annotations](/vault-api/api-reference/24.2/documents/document-annotations/create-multiple-annotations) for details. Replies that were not added successfully are reported with an error message.



---

**Previous:** [Create Multiple Annotations](/regulatory/vault-api/api-reference/24.2/documents/document-annotations/create-multiple-annotations)  
**Next:** [Update Annotations](/regulatory/vault-api/api-reference/24.2/documents/document-annotations/update-annotations)