> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lev8.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich

> Generate structured fields for an entity from context and a JSON Schema.

[`POST /v1/enrich`](/api-reference/enrich/create) reads `entity_context` and returns structured enrichment fields described by `enrich_fields`.

Use Enrich when you already have an entity and want to fill additional fields such as a company summary, current CEO, category, or other structured attributes.

## Headers

| Header                           | Required    | Description                                                                                            |
| -------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------ |
| `Content-Type: application/json` | Yes         | Other media types return `422`.                                                                        |
| `Accept: application/json`       | Recommended | Declares that the client expects a JSON response.                                                      |
| `Authorization`                  | Yes         | `Bearer lev8_live_...` -- an active Lev8 API key with Enrich access.                                   |
| `Idempotency-Key`                | No          | Stable key for safely replaying the same logical request. Lev8 generates and returns one when omitted. |

## Request body

| Field            | Type   | Required | Description                                                                                                               |
| ---------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `entity_context` | string | Yes      | Context for the entity, such as name, website, social handles, or an existing description. Maximum 16 KiB after trimming. |
| `enrich_fields`  | object | Yes      | Non-empty object JSON Schema describing the fields to generate. Maximum 256 KiB, 12 levels, and 200 properties.           |

## Response

On success, `answer` tries to match the requested `enrich_fields` schema.

```json theme={null}
{
  "success": true,
  "answer": {
    "company_summary": "OpenAI is an AI research and product company.",
    "ceo": "Sam Altman"
  }
}
```

Errors outside the Enrich workflow use the standard [error envelope](/api-reference/errors).