Workspaces
Automatic search
Other errors (500, 502, 503) are on Errors.
Other errors (500, 502, 503) are on Errors.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer nace_sk_...
- Where: the dashboard's API Keys page. It is shown once, when you create it.
- Format:
nace_sk_followed by 43 URL-safe characters (A-Z,a-z,0-9,_and-). - Limit: an account can hold at most 3 active keys.
- Wrong or missing key: returns
401 authentication_error.
In: header
Path Parameters
The workspace's workspace_id.
Query Parameters
Hold the request open until the job finishes, up to this many seconds. 0 (default) returns at once; a value above 60 waits 60.
0 <= valueHeader Parameters
Up to 200 characters, unique per account. Retry identical inputs with the same key to get the original job; use a new key for changed inputs.
length <= 200Request Body
application/json
1 <= length <= 4096Background the answer takes as given.
length <= 20000Search only the files under this folder.
Search exactly these files too, by path.
A JSON Schema the answer must follow; the result's structured_answer holds it.
Show child attributes
How many evidences a fact answer cites.
1 <= value <= 506"auto""auto""fact""agent"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces/string/automatic-search" \ -H "Content-Type: application/json" \ -d '{ "query": "What were total liabilities at year end?", "path_prefix": "reports/2025" }'{ "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f", "kind": "string", "status": "queued", "workspace_id": "string", "result": null}