Skip to main content
POST
Generate the AI context from a domain

Authorizations

Authorization
string
header
required

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

Body

application/json

Request body for starting a generation from a company domain.

domain
string
required

A bare company domain like 'acme.com' — no scheme or path.

Required string length: 1 - 255

Response

Successful Response

A generation job's current state. Poll this until status is terminal.

created_at
string<date-time>
required
domain
string
required

The domain this job is researching.

error
string | null
required

Why generation failed — infra trouble, or too little public content.

id
string<uuid>
required
status
enum<string>
required

Where a context-generation job has got to.

Jobs are born RUNNING — creation validates, inserts and queues the workflow in one call, so there is no separate committed-but-not-started phase. PENDING exists for schema parity with the other job enums and is never observed. The two terminal states are absorbing: a job never leaves them.

Available options:
pending,
running,
succeeded,
failed
updated_at
string<date-time>
required