---
title: "Changes to Run a deep-research agent (multi-step research, async)"
method: POST
path: "/api/mpp/v1/agent/runs"
---

# Changes to Run a deep-research agent (multi-step research, async)

`POST /api/mpp/v1/agent/runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 16 revisions.

- **2026-10-20** `2af0a2d68ee3`: 1 info
- **2026-09-17** `5cfc05af25d8`: 6 info
- **2026-09-01** `d92f4a77f5ab`: 1 breaking, 7 info

## Changes

- **2026-10-20** `2af0a2d68ee3`: 1 info
  - added the non-success response with the status `502`
- **2026-09-17** `5cfc05af25d8`: 6 info
  - added the new optional request property `effort`
  - added the new optional request property `locale`
  - added the new optional request property `output_settings`
  - added the new optional request property `thread_id`
  - added the new optional request property `timezone`
  - request property `source_indexes` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-09-01** `d92f4a77f5ab`: 1 breaking, 7 info
  - removed the success response with the status `200`
  - added the media type `application/json` for the response with the status `202`
  - added the media type `application/problem+json` for the response with the status `402`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/tako/apis/tako-api/docs/api/mpp/v1/agent/runs/post.md) - [API](https://skmtc.dev/tako/apis/tako-api.md) - [Page](https://skmtc.dev/tako/apis/tako-api/changes/api/mpp/v1/agent/runs/post)
