> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/icp-enrichment/update-icp.md).

# Update ICP

Update an ICP's name, natural-language text, and/or match threshold.

## Update ICP

<mark style="color:green;">`POST`</mark> `/update_icp`

{% hint style="info" %}
Free — no credits are charged. Provide `icp_id` plus any of the optional fields you want to change.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name              | Type         | Description                                 |
| ----------------- | ------------ | ------------------------------------------- |
| `api_key`         | string       | Your API Key.                               |
| `icp_id`          | integer      | The id of the ICP to update.                |
| `match_threshold` | number (0–1) | Optional. New match cutoff.                 |
| `name`            | string       | Optional. New ICP name.                     |
| `nl_text`         | string       | Optional. New natural-language description. |

**Response**

The saved ICP is returned under `data`, with your changes applied. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "icp_id": 26,
  "match_threshold": 0.75
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "id": 26,
    "name": "Sales Director Small Company",
    "summary": "Targeting sales directors in companies with more than 10 employees.",
    "nl_text": "sales director for company having more than 10 headcount",
    "match_threshold": 0.75,
    "is_active": false,
    "updated_at": "2026-07-22T23:35:00Z"
  },
  "credits_used": 0,
  "credits_remaining": 4005.0,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "not_found",
    "message": "ICP not found"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}