### PATCH /api/v4/enrichments/{id}

**Change what to update** (`configure_enrichment`). Change update before approval. Returns a new quote without re-running the check.

Free. API key required. Success: `200`. Accepts `Idempotency-Key`.

#### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Enrichment UUID. |

#### Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `update` | object | yes | Which data to refresh from the web. true = refresh data older than 6 months; {"freshness":"12m"\|"6m"\|"30d"\|"always"}; false or omitted = keep StartupSeeker data. |
| `update.details` | boolean \| object |  |  |
| `update.funding` | boolean \| object |  |  |
| `update.founders` | boolean \| object |  |  |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes | The result. |
| `data.id` | string | yes | UUID. |
| `data.type` | "enrichment" | yes |  |
| `data.status` | "quoting" \| "awaiting_approval" \| "queued" \| "running" \| "canceling" \| "succeeded" \| "partially_succeeded" \| "failed" \| "canceled" | yes |  |
| `data.check_only` | boolean | yes |  |
| `data.client_reference` | string \| null | yes |  |
| `data.created_at` | string | yes | ISO 8601 timestamp (UTC). |
| `data.finished_at` | string \| null | yes |  |
| `data.update` | object \| null | yes |  |
| `data.progress` | object | yes |  |
| `data.progress.companies` | integer | yes |  |
| `data.progress.checked` | integer | yes |  |
| `data.progress.vc_backable` | integer | yes |  |
| `data.progress.ready` | integer | yes |  |
| `data.progress.issues` | integer | yes |  |
| `data.quote` | object \| null | yes |  |
| `data.quote.quote_id` | string | yes | UUID. |
| `data.quote.max_cost_usd_cents` | integer | yes | USD cents. |
| `data.quote.expires_at` | string | yes | ISO 8601 timestamp (UTC). |
| `data.quote.new_companies` | integer | yes |  |
| `data.quote.lines` | array<object> | yes |  |
| `data.cost` | object | yes |  |
| `data.cost.reserved_usd_cents` | integer | yes | USD cents. |
| `data.cost.charged_usd_cents` | integer | yes | USD cents. |
| `data.cost.refunded_usd_cents` | integer | yes | USD cents. |
| `data.failure` | object \| null | yes |  |
| `data.failure.stage` | "check" \| "run" | yes |  |
| `meta.request_id` | string | yes | Request id (also in X-Request-Id). |
| `meta.cost_usd_cents` | number | yes | Charged for this request, in USD cents. |

#### Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `VALIDATION_FAILED` | The request does not match the endpoint contract. |
| 401 | `UNAUTHORIZED` | The API key is missing, invalid or revoked. |
| 404 | `NOT_FOUND` | The record or resource does not exist for this account. |
| 409 | `IDEMPOTENCY_MISMATCH` | This Idempotency-Key was already used with a different request. |
| 409 | `IDEMPOTENCY_IN_PROGRESS` | A request with this Idempotency-Key is still running. |
| 409 | `JOB_NOT_CONFIGURABLE` | The job can no longer be reconfigured. |
| 409 | `CHECK_ONLY_JOB` | A check-only enrichment has nothing to approve or configure. |
| 409 | `CONFLICT` | The resource changed concurrently or already exists. |
| 429 | `RATE_LIMITED` | Too many requests in the current window. |
| 500 | `INTERNAL_ERROR` | An unexpected server error. |
| 503 | `SERVICE_UNAVAILABLE` | A dependency is temporarily unavailable. |

#### Example

```bash

curl -X PATCH 'https://startup-seeker.com/api/v4/enrichments/11111111-1111-4111-8111-111111111111' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "update": {
      "details": true,
      "funding": {
        "freshness": "always"
      }
    }
  }' \
  -H "Idempotency-Key: $(uuidgen)"

```