---
title: "Api Generate Message"
method: POST
path: "/api/generations/{id}/nl-generation"
tags: ["Aggregated Generation"]
---

# Api Generate Message

`POST /api/generations/{id}/nl-generation`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- NLGenerationResponse
  - `id` string
  - `text` string
  - `sql_generation_id` string
  - `metadata` NLGenerationMetadata
    - `dh_internal` DHNLGenerationMetadata
      - `organization_id` string
  - `created_at` string, date-time

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/dataherald/apis/dataherald-api.md) - [All operations](https://skmtc.dev/dataherald/apis/dataherald-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dataherald/apis/dataherald-api/revisions/e168e98625a8?raw)