# Save data catalog entries (/docs/reference/Rest-API/api-docs/data-catalogs/saveDataCatalogEntries)


{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

## POST /v2/organizations/{organizationid}/data-catalogs/{catalogid}/entries

`POST https://api.verdocs.com/v2/organizations/{organizationid}/data-catalogs/{catalogid}/entries`

### Path parameters

- `organizationid` (string, required)
- `catalogid` (string, required)

### Request body

Content type `application/json`, required. Body Parameters.

- `entries` (ISaveDataCatalogEntry[], required): Up to 500 entries. Each key may appear only once.
  - `description` (string): What the value is.
  - `example` (string): An example value.
  - `key` (string, required): Letters, digits, "_", and "-", with "." between levels.
  - `label` (string, required): What template owners see for this key.
  - `options` (string): For a choice, the accepted values.
  - `sensitive` (boolean): Keeps the example out of MCP answers and AI prompts. Defaults to false.
  - `type` (string): Defaults to text. A choice needs options.

### Responses

#### 200: Success

Content type `application/json`.

Type: `IDataCatalogEntry[]`

- `catalog_id` (string, required): The catalog the entry belongs to.
- `created_at` (string, required): When the entry was created.
- `description` (string, required): What the value is.
- `example` (string, required): An example value, real or made up, as the organization chose.
- `id` (string, required): The entry's ID.
- `key` (string, required): Matches the data_key on template and envelope fields, such as "applicant.full_name".
- `label` (string, required): What template owners see for this key, such as "Applicant name".
- `options` (string, required): For a choice, the accepted values.
- `proposed_by` (string, required): The profile that proposed the entry, if a member did.
- `sensitive` (boolean, required): Keeps the example out of MCP answers and AI prompts.
- `source_entry` (string, required): For an entry imported from the marketplace, the source's version of it, used to review updates.
- `status` (string, required): "active" entries can be used; "proposed" entries wait for an admin to approve them.
- `type` (string, required): What a caller sends for this key.
- `updated_at` (string, required): When the entry last changed.

#### 400: Request Error

Content type `application/json`.

- `status` (string, required): Always set to "ERROR". One of: `"ERROR"`.
- `error` (string, required): Description of the error that occurred.

#### 401: Access Denied

Content type `application/json`.

- `status` (string, required): Always set to "ERROR". One of: `"ERROR"`.
- `error` (string, required): Description of the error that occurred.

#### 404: Not Found

Content type `application/json`.

- `status` (string, required): Always set to "ERROR". One of: `"ERROR"`.
- `error` (string, required): Description of the error that occurred.

#### 406: Invalid Parameter

Content type `application/json`.

- `status` (string, required): Always set to "ERROR". One of: `"ERROR"`.
- `error` (string, required): Description of the error that occurred.

### Example request

```bash
curl -X POST "https://api.verdocs.com/v2/organizations/ORGANIZATIONID/data-catalogs/CATALOGID/entries" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -H "content-type: application/json" \
    -d '{"param": "value"}'
```