---
title: "Changes to Get the status or result of a background research task"
method: GET
path: "/v1/research/{task_id}"
---

# Changes to Get the status or result of a background research task

`GET /v1/research/{task_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-08-04** `24d9e2eb5297`: 5 breaking, 1 warning, 10 info
- **2026-07-31** `dfadf8aeab9b`: 1 info

## Changes

- **2026-08-04** `24d9e2eb5297`: 5 breaking, 1 warning, 10 info
  - response property `completed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `error` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `updated_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `#/components/schemas/ResearchOutput, subschema #2` to the `result` response property `oneOf` list for the response status `200`
  - the `result` response's property type changed from `object` to no type for status `200`
  - added the new `research` enum value to the `task_type` response property for the response status `200`
  - the response property `completed_at` became required for the status `200`
  - the response property `error` became required for the status `200`
  - the response property `input` became required for the status `200`
  - the response property `result` became required for the status `200`
  - added the required property `input/background` to the response with the `200` status
  - added the required property `input/input` to the response with the `200` status
  - added the required property `input/output_schema` to the response with the `200` status
  - added the required property `input/research_effort` to the response with the `200` status
  - added the required property `input/source_control` to the response with the `200` status
  - added the required property `input/type` to the response with the `200` status
- **2026-07-31** `dfadf8aeab9b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/you/apis/you-com-research-api/docs/v1/research/:task_id/get.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/:task_id/get)