v2

OpenAPI 3.1.02026-07-264960204.2 KB

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.

post/contacts/discover/generate

Request body

icp_textstring required
domainsstring[] required
context_mode'website' | 'profile' | 'domain'
integration_idstring nullable
search_provider_idstring nullable
search_context_size'low' | 'medium' | 'high'
max_contacts_per_domaininteger
max_company_recordsinteger nullable
full_domainsstring[] nullable
partial_domainsstring[] nullable
initial_contact_countsobject nullable

Response

Successful Response

task_idstring required

Unique task identifier for polling status

status'in_progress' required

Task status: in_progress

total_domainsinteger required

Total number of domains to process