---
title: "Changes to run extraction"
method: POST
path: "/extractions/{id}/runs"
---

# Changes to run extraction

`POST /extractions/{id}/runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 20 revisions.

- **2026-11-13** `fac56b649559`: 1 warning
- **2026-10-30** `dcb4d45ade1a`: 12 info
- **2026-10-26** `246d92c52951`: 1 info
- **2026-10-13** `029668894d33`: 13 info
- **2026-10-07** `76d39731705b`: 1 breaking, 1 warning, 2 info
- **2026-09-29** `bb5cecaae5ac`: 1 warning
- **2026-09-14** `9dc1cf6b2c65`: 1 breaking, 1 info
- **2026-09-09** `607d3222bfcd`: 8 info

## Changes

- **2026-11-13** `fac56b649559`: 1 warning
  - removed the optional property `allOf[#/components/schemas/Run]/legacy` from the response with the `201` status
- **2026-10-30** `dcb4d45ade1a`: 12 info
  - added the optional property `allOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `201` status
  - added the optional property `credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `200` status
  - added the optional property `credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `200` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `404` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `422` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `404` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `422` status
- **2026-10-26** `246d92c52951`: 1 info
  - added the optional property `allOf[#/components/schemas/Run]/legacy` to the response with the `201` status
- **2026-10-13** `029668894d33`: 13 info
  - added the optional property `allOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/added_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/completed_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/generated_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/requested_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/running_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/skipped_duplicate_rows` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Run]/progress/total_rows` to the response with the `201` status
  - added the optional property `credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `200` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `404` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `422` status
- **2026-10-07** `76d39731705b`: 1 breaking, 1 warning, 2 info
  - removed the required property `dry_run` from the response with the `200` status
  - removed the request property `dry_run`
  - added the new optional request property `estimate_cost`
  - added the required property `estimate_cost` to the response with the `200` status
- **2026-09-29** `bb5cecaae5ac`: 1 warning
  - added the new `monitor` enum value to the `type` response property for the response status `200`
- **2026-09-14** `9dc1cf6b2c65`: 1 breaking, 1 info
  - the response property `allOf[#/components/schemas/Run]/progress/not_found_cells` became nullable for the status `201`
  - added the optional property `allOf[#/components/schemas/Run]/stopped_reason` to the response with the `201` status
- **2026-09-09** `607d3222bfcd`: 8 info
  - added the new optional request property `dry_run`
  - added the new optional request property `max_credits`
  - added the optional property `error/credit_detail` to the response with the `400` status
  - added the optional property `error/credit_detail` to the response with the `403` status
  - added the optional property `error/credit_detail` to the response with the `404` status
  - added the optional property `error/credit_detail` to the response with the `422` status
  - added the required property `allOf[#/components/schemas/Run]/credit_detail` to the response with the `201` status
  - added the success response with the status `200`

---

[Operation](https://skmtc.dev/riveterhq/apis/riveter-api/docs/extractions/:id/runs/post.md) - [API](https://skmtc.dev/riveterhq/apis/riveter-api.md) - [Page](https://skmtc.dev/riveterhq/apis/riveter-api/changes/extractions/:id/runs/post)
