Skip to main content
POST
Start an investigation

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Body

application/json
lead_info
Lead Info · object
required

Who to investigate, e.g. {"name": "Jane Doe", "company": "Acme"}.

engine
enum<string>
default:xhigh

Research engine. GET /v1/atlas/access reports which ones this organization may run, and what each costs.

Available options:
xhigh,
scout
research_plan
string | null

Direction for this run. On a continue, what to look into next.

Maximum string length: 100000
struct
Struct · object | null

Optional output schema. Atlas researches open-endedly into the workspace either way.

relentless
boolean
default:true

Research until the budget runs out (the Atlas default). Set false to let a run with struct stop once every field is answered, charging the turns it used (at least one unit).

max_credits
integer | null

How much research to buy, in credits (default: one unit of the engine price), up to 10 units. See Credits & Pricing.

max_minutes
integer | null

The most minutes of research time; waiting to retry does not count. When reached, the run writes up its findings, which can take a few minutes, and is charged only for the research it used. Default: no limit.

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

An idempotency key you generate. A retry with the same key returns the run already started instead of starting and charging a second one.

Required string length: 8 - 128
task
string | null

Build an org chart with the xHigh research harness.

Allowed value: "org_chart"
name
string | null

Title for the investigation. Derived from lead_info when unset.

Maximum string length: 1000
private
boolean
default:false

Visible only to you, not your team. With an API key, the run is private to the person who created the key. Your team must allow private runs.

Response

Investigation and run identifiers for following progress.

task_id
string
required

Poll with GET /job-status/{job_id}.

status
string
required
investigation
InvestigationReference · object
required

The investigation this run writes into; readable while the run works.