---
title: "Start deep research"
method: POST
path: "/api/deep-research"
tags: ["Deep Research"]
---

# Start deep research

`POST /api/deep-research`

Start a deep research job with a prompt and JSON Schema. The response includes an operation ID and poll URL for retrieving the structured result.

## Headers

- `Idempotency-Key` string

## Request body

- DeepResearchRequestDto
  - `prompt` string, required — Research instructions.
  - `schema` object, required — JSON Schema that defines the dynamic shape of result.data returned after the operation completes.
  - `model` string — Optional model override.
  - `urls` string[] — Optional seed URLs to prioritize during research.
  - `inputAnchors` union — Optional caller-owned anchor metadata overlaid into matching schema paths. Arrays preserve the previously documented contract; objects support keyed anchors used by the runtime.
    - object[]
    - object
  - `maxCredits` integer — Maximum credits to spend. Must match budget.maxCredits when both are provided.
  - `budget` DeepResearchBudgetRequestDto
    - `maxCredits` integer — Maximum credits to spend on this research run.
  - `enrich` boolean — Set false to disable server-side schema enrichment and fill exactly the supplied schema. Closed schemas (additionalProperties:false) are never enriched.
  - `confirm` boolean — Set true to continue after a confirmation_required estimate warning.

## Response `202`

Research job accepted. Poll the returned URL for status and results.

- DeepResearchQueuedResponseDto
  - `id` string, required
  - `operationId` string, required
  - `status` 'queued', required
  - `pollUrl` string, required
  - `meta` DeepResearchAcceptedMetaDto
    - `schemaContract` object

## Other responses

- `400` — The request body or parameters are invalid.
- `401` — Authentication is required.
- `402` — The organization does not have enough credits for this request.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/thehog/apis/the-hog-api.md) · [All operations](https://skmtc.net/thehog/apis/the-hog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thehog/the-hog-api/revisions/f5056017668a/schema)