POST
Run grounded multi-source research on a topic

Authorizations

Authorization
string
header
default:tok_public_demo
required

Send a workspace API token in the Authorization: Bearer <token> header.

Keys carry the satk_ prefix and spend your organization's credit balance. GET /v1/public/balance reports what is left.

Test-mode keys (satk_test_), which drew on a separate self-refilling allowance, have been retired and no longer authenticate.

Headers

Idempotency-Key
string

Optional deduplication key, scoped to your organization. Re-sending a request with a key that was already used returns the original job instead of creating and charging for a second one.

Supersedes the idempotencyKey body field, which remains supported as a deprecated alias. If both are present, this header wins.

Maximum string length: 255

Body

application/json
topic
object
required
targetKeywords
string[]
researchProfile
enum<string> | null

Omit or null to auto-classify. "complex" selects the heavier deep tier.

Available options:
simple,
complex
seedUrls
string<uri>[]
trustedCandidates
object[]
options
object
wait
boolean
default:false
waitTimeoutMs
integer
webhookUrl
string<uri> | null
idempotencyKey
string
cacheTtlSec
integer
fresh
boolean

Response

The terminal evidence pack. Documented for the shape of result; this endpoint always answers 202 in practice (see above).

data
object
required