Skip to main content
POST
Create Run

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Unified run input. At least one input source must be provided. Seeds are classified server-side; vague seeds climb the resolution waterfall and may pause at the resolution gate before the expensive research fan-out.

name
string | null
company_names
string[]
Maximum array length: 500
company_websites
string[]
Maximum array length: 500
company_linkedin_urls
string[]
Maximum array length: 500
person_names
PersonNameInput · object[]
Maximum array length: 500
person_linkedin_urls
string[]
Maximum array length: 500
icp
ICPConfigBody · object | null

Ideal-customer-profile filters for discovering NEW companies (ICP mode).

The review-score maxes (trustpilot_max, bbb_max, g2_max) are pain signals, not quality bars: this pipeline sells CX-improvement services, so a LOWER rating means MORE pain and a BETTER prospect. A company only needs to clear one rating ceiling (or have CFPB complaints) to qualify — see cx_intel/qualification.py:gate_3_pain_threshold.

discovery_count
integer | null
Required range: 1 <= x <= 200
lookalike_seeds
LookalikeSeed · object[]
Maximum array length: 50
document
DocumentRef · object | null

A document the user uploaded to /customer-intelligence/uploads. Claude reads it during intake (the ci_extract_document activity) and extracts lead identifiers as seeds; low-confidence extractions pause at the resolution gate just like vague typed input.

deliverables
DeliverableSelection · object

Which deliverable kinds this run may produce, and optional per-kind model overrides. Which targets get the deep kinds is chosen at the shortlist gate, not here.

phases
PhaseToggles · object
champion
ChampionConfig · object
concurrency
ConcurrencyConfig · object
providers
ProviderConfig · object
webhook_url
string | null
org_slug
string | null
requester_email
string | null

Response

Successful Response

id
string
required
org_id
string
required
status
string
required
name
string | null
phase
string | null
awaiting_gate
string | null
temporal_workflow_id
string | null
targets_total
integer
default:0
targets_completed
integer
default:0
targets_scored
integer
default:0
targets_errored
integer
default:0
targets_filtered
integer
default:0
outcome_counts
Outcome Counts · object
deliverables
Deliverables · object
report_files
Report Files · object
shortlist_selection
Shortlist Selection · object
cost
Cost · object | null
health
Health · object | null
error
string | null
created_by
string | null
created_at
string | null
updated_at
string | null