---
title: "Changes to Returns comprehensive research-grade answers with multi-step reasoning"
method: POST
path: "/v1/research"
---

# Changes to Returns comprehensive research-grade answers with multi-step reasoning

`POST /v1/research`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-08-04** `24d9e2eb5297`: 3 breaking, 39 info
- **2026-07-31** `dfadf8aeab9b`: 3 breaking, 3 info

## Changes

- **2026-08-04** `24d9e2eb5297`: 3 breaking, 39 info
  - request property `source_control/country` was restricted to a list of enum values
  - the `source_control/freshness` request property type changed from `string` to no type
  - added `#/components/schemas/ResearchOutput, #/components/schemas/ResearchTask` to the response body `oneOf` list for the response status `200`
  - added the new `AR` enum value to the request property `source_control/country`
  - added the new `AT` enum value to the request property `source_control/country`
  - added the new `AU` enum value to the request property `source_control/country`
  - added the new `BE` enum value to the request property `source_control/country`
  - added the new `BR` enum value to the request property `source_control/country`
  - added the new `CA` enum value to the request property `source_control/country`
  - added the new `CH` enum value to the request property `source_control/country`
  - added the new `CL` enum value to the request property `source_control/country`
  - added the new `CN` enum value to the request property `source_control/country`
  - added the new `DE` enum value to the request property `source_control/country`
  - added the new `DK` enum value to the request property `source_control/country`
  - added the new `ES` enum value to the request property `source_control/country`
  - added the new `FI` enum value to the request property `source_control/country`
  - added the new `FR` enum value to the request property `source_control/country`
  - added the new `GB` enum value to the request property `source_control/country`
  - added the new `HK` enum value to the request property `source_control/country`
  - added the new `ID` enum value to the request property `source_control/country`
  - added the new `IN` enum value to the request property `source_control/country`
  - added the new `IT` enum value to the request property `source_control/country`
  - added the new `JP` enum value to the request property `source_control/country`
  - added the new `KR` enum value to the request property `source_control/country`
  - added the new `MX` enum value to the request property `source_control/country`
  - added the new `MY` enum value to the request property `source_control/country`
  - added the new `NL` enum value to the request property `source_control/country`
  - added the new `NO` enum value to the request property `source_control/country`
  - added the new `NZ` enum value to the request property `source_control/country`
  - added the new `PH` enum value to the request property `source_control/country`
  - added the new `PL` enum value to the request property `source_control/country`
  - added the new `PT` enum value to the request property `source_control/country`
  - added the new `RU` enum value to the request property `source_control/country`
  - added the new `SA` enum value to the request property `source_control/country`
  - added the new `SE` enum value to the request property `source_control/country`
  - added the new `TR` enum value to the request property `source_control/country`
  - added the new `TW` enum value to the request property `source_control/country`
  - added the new `US` enum value to the request property `source_control/country`
  - added the new `ZA` enum value to the request property `source_control/country`
  - added the new `frontier` enum value to the request property `research_effort`
  - …2 more
- **2026-07-31** `dfadf8aeab9b`: 3 breaking, 3 info
  - added `#/components/schemas/ResearchResponse, #/components/schemas/TaskResponse` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `output` from the response with the `200` status
  - added the new optional request property `background`
  - added the new optional request property `output_schema`
  - added the new optional request property `source_control`

---

[Operation](https://skmtc.dev/you/apis/you-com-research-api/docs/v1/research/post.md) - [API](https://skmtc.dev/you/apis/you-com-research-api.md) - [Page](https://skmtc.dev/you/apis/you-com-research-api/changes/v1/research/post)