# Update a data catalog entry (/docs/reference/Rest-API/api-docs/data-catalogs/updateDataCatalogEntry)


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

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

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

### Path parameters

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

### Request body

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

- `label` (string): What template owners see for this key.
- `type` (string): What a caller sends for this key. One of: `"text"`, `"date"`, `"boolean"`, `"choice"`.
- `description` (string): What the value is.
- `example` (string): An example value.
- `options` (IDataCatalogOption[]): For a choice, the accepted values.
  - `label` (string, required): What the signer sees for this choice.
  - `value` (string, required): What to send in prefill_data. The label is accepted too.
- `sensitive` (boolean): Keeps the example out of MCP answers and AI prompts.
- `status` (string): Set to "active" to approve a proposal. One of: `"active"`.

### Responses

#### 200: Success

Content type `application/json`.

Type: `IDataCatalogEntry`

An entry's content, as versions freeze it and update reviews compare it.

- `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 PATCH "https://api.verdocs.com/v2/organizations/ORGANIZATIONID/data-catalogs/CATALOGID/entries/KEY" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -H "content-type: application/json" \
    -d '{"param": "value"}'
```