---
title: "Contacts Discover Generate"
method: POST
path: "/contacts/discover/generate"
---

# Contacts Discover Generate

`POST /contacts/discover/generate`

Dispatch a BYOK DiscoGen task that discovers contacts at each given company domain.

Builds a `test_discogen_prompt.py`-style multi-row query ("Find X. Return A | B | C per line.")
from the ICP text. DiscoGen auto-detects the response format and runs the query per-domain
with web search enabled. Poll GET /discogen/status/{task_id} for results.

BYOK: uses the caller's own LLM and search provider keys. DiscoLike does not bill
per contact returned. Results may include hallucinated personas - callers must
treat `email`, `linkedin_url`, and other identifying fields as candidate data
until validated.

## Request body

- BodyContactsDiscoverGenerateContactsDiscoverGeneratePost
  - `icp_text` string, required
  - `domains` string[], required
  - `context_mode` 'website' | 'profile' | 'domain'
  - `integration_id` string, nullable
  - `search_provider_id` string, nullable
  - `search_context_size` 'low' | 'medium' | 'high'
  - `max_contacts_per_domain` integer
  - `max_company_records` integer, nullable
  - `full_domains` string[], nullable
  - `partial_domains` string[], nullable
  - `initial_contact_counts` object, nullable

## Response `200`

Successful Response

- DiscoGenTaskResponse — Initial response from /discogen/process endpoint (202 Accepted).
  - `task_id` string, required — Unique task identifier for polling status
  - `column_name` union, required — AI-generated or user-provided column name(s) for results
    - string
    - string[]
  - `status` 'in_progress', required — Task status: in_progress
  - `total_domains` integer, required — Total number of domains to process

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/discolike/apis/discolike-api.md) · [All operations](https://skmtc.net/discolike/apis/discolike-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discolike/discolike-api/revisions/3248fc62024c/schema)