---
title: "Run enrichment for resource"
method: POST
path: "/api/v2/supersearch-enrichment/run"
tags: ["SuperSearchEnrichment"]
---

# Run enrichment for resource

`POST /api/v2/supersearch-enrichment/run`

Run all enrichments associated with a resource for a list of leads or for all the leads that haven't been enriched yet

## Request body

- object
  - `resource_id` string, uuid, required — The ID of the resource (list or campaign) to run enrichments for
  - `lead_ids` string[] — List of lead IDs to enrich (optional)
  - `limit` integer — If set, only the first N leads will be enriched
  - `column_name` string — AI enrichment column to run.
  - `overwrite` boolean — (AI re-run parameter) If true, run even if column has value. If false (default), only process empty/null columns. Requires column_name.
  - `starting_row` integer — (AI re-run parameter) Starting lead position (inclusive, 1-indexed). Defaults to 1 if not provided. Requires column_name.
  - `count` integer — (AI re-run parameter) How many leads to process. If not provided, processes all remaining leads from starting_row to the end. Requires column_name.
  - `filters` object[] — Conditional formula filters to apply when processing leads. Only leads matching all filters will be enriched.
    - `column_name` string, required — Lead column key to filter on
    - `type` number, required — Backend filter type enum value
    - `value` string[], required — Filter values (empty array for is-empty / is-not-empty style filters)

## Response `200`

Default Response

- object
  - `id` string — The ID of the enrichment
  - `resource_id` string — The ID of the resource (list or campaign) to enrich
  - `enrichment_payload` object — The payload of the enrichment

## Other responses

- `400` — Default Response
- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)