Skip to main content
POST
People Intelligence (Sync)

Headers

x-api-key
string | null

Body

application/json
lead_info
Lead Info · object
required

Single lead to process. Provide any combination of name, email, company, linkedin, etc.

struct
Struct · object | null

Mapping of output field name to natural-language description of what to extract. A field that asks for an image (a headshot, a logo, a screenshot of a page) is returned as an image URL on api.sixtyfour.ai/v1/media, hosted by Sixtyfour; embed it directly. It works until the investigation that saved the image, or the organization, is permanently deleted.

research_plan
string | null

Optional natural-language plan that guides the research agent.

tier
enum<string> | null

Quality and cost tier for the research agent.

Available options:
low,
micro,
medium,
high,
xhigh,
scout
webhook_url
string<uri> | null

HTTPS URL that receives the result payload when the async job completes.

Required string length: 1 - 2083
field_confidence
boolean | null

If true, return each requested field's confidence (0-100), justification and source URLs, nested like the request.

graph
boolean | null

Only with tier "scout": set true to run Scout as an Atlas run. The run is saved as an Atlas investigation you can open in the Sixtyfour app, export, and continue later with investigation_id; the async response returns it under investigation. It takes the Atlas run options (max_credits, max_minutes, relentless, investigation_id, investigation_name, include_workspace), and struct becomes optional. It is billed per unit of research instead of Scout's standard price: 50 credits a unit. It must be enabled for your organization, and true with any other tier is rejected. Omitted or false, Scout runs as usual.

include_workspace
boolean | null

For Atlas runs (xhigh, or scout with graph), include workspace files alongside structured output (default: true). Set false to omit them. Job status reads them from the investigation, so it shows the investigation's current workspace, including what a later run on it changed. Saved images appear as attachment records; requested image fields carry their /v1/media URL, and the investigation's /v1/atlas file API serves any attachment. Ignored by other tiers.

investigation_id
string | null

For Atlas runs (xhigh, or scout with graph), continue an existing investigation instead of creating one. The run reuses that investigation's graph and workspace, so a follow-up builds on the earlier research rather than starting over. Ignored by other tiers.

investigation_name
string | null

For Atlas runs, the title of a newly created investigation. Ignored when resuming via investigation_id; when unset the title is derived from lead_info.

relentless
boolean
default:false

For Atlas runs with struct: research until the budget runs out. By default a run may stop once every requested field is answered, and is then charged for the research it used (at least one unit).

max_credits
integer | null

For Atlas runs, how much research to buy, in credits: one unit of the tier price by default, up to 10 units. A unit is 250 credits on xhigh and 50 on scout with graph. Research scales with the credits bought, and the whole budget is used and charged unless the run stops early; see relentless and max_minutes.

max_minutes
integer | null

For Atlas runs, the longest the run may research, in minutes of working time: time spent waiting to retry after a temporary failure does not count. When it is reached the run writes up what it found and completes, and is charged for the research it used, rounded up to the next 50 credits, instead of the whole budget. Writing up can take a few minutes past the limit. Default: no limit.

Required range: 10 <= x <= 1440
dispatch_id
string | null

Async endpoints only: a client-generated idempotency key for the dispatch. Reusing the same key for the same organization returns the existing job instead of starting and billing a duplicate.

Required string length: 8 - 128
exclusive_run
boolean
default:false

Atlas runs on an existing investigation only: refuse with 409 while that investigation already has a run starting or running, instead of starting and billing a second one.

Response

Successful Response