**Source URL:** https://limited.veevavault.dev/clinical/vault-api/api-reference/25.3/clinical-operations/generate-milestone-documents

# Generate Milestone Documents

Generate *Milestone Document* records for up to 500 milestones. *Milestone Document* records are used to display matched document details in the Milestone Workspace.

Learn more about the [Milestone Workplace in Vault Help](https://clinical.veevavault.help/en/gr/496924/).

<Endpoint path="/api/{version}/app/clinical/milestone/actions/generatemilestonedocuments" method="POST" />

## Headers

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `text/csv` |
</FieldTable>

## Body Parameters

The CSV file must have a single column with the header `id`. List each milestone ID on a separate row below. Including more than 500 rows results in an error.

## Request

<CodeExample title="">
```bash
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: text/csv" \
"https://myvault.veevavault.com/api/v24.1/app/clinical/milestone/actions/generatemilestonedocuments"
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
    "responseStatus": "SUCCESS",
    "SUCCESS": "Successfully generated milestone documents"
}
```
</CodeExample>

## Response Details

On `SUCCESS`, Vault starts an *Add Expected Documents* job to create the *Milestone Document* records. On completion, Vault sends an email notification containing a link to download a list in CSV format of successfully created records.

---

**Previous:** [Execute Milestone Story Events](/clinical/vault-api/api-reference/25.3/clinical-operations/execute-milestone-story-events)  
**Next:** [Veeva Site Connect: Distribute to Sites](/clinical/vault-api/api-reference/25.3/clinical-operations/veeva-site-connect-distribute-to-sites)