---
title: "Changes to List Docs"
method: POST
path: "/documents"
---

# Changes to List Docs

`POST /documents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 14 revisions.

- **2026-01-22** `2d9291c3821d`: 1 breaking, 1 warning, 21 info
- **2025-12-18** `4b79c3821a17`: 1 warning, 5 info
- **2025-12-06** `e185c542e939`: 2 info
- **2025-11-27** `4ce03d9b0f27`: 1 info
- **2025-11-13** `b9ae748cb938`: 1 info
- **2025-11-05** `9ade02dd7b1d`: 1 breaking, 1 info

## Changes

- **2026-01-22** `2d9291c3821d`: 1 breaking, 1 warning, 21 info
  - the response's body type changed from `array` to `object` for status `200`
  - the `limit` request property's min was set to `0.00`
  - api operation id `list_documents_documents_post` removed and replaced with `list_docs_documents_post`
  - added the new optional request property `completed_only`
  - added the new optional request property `fields`
  - added the new optional request property `include_folder_counts`
  - added the new optional request property `include_status_counts`
  - added the new optional request property `include_total_count`
  - added the new optional request property `return_documents`
  - added the new optional request property `sort_by`
  - added the new optional request property `sort_direction`
  - `header` request parameter `authorization` list-of-types was widened by adding types `null`
  - for the `header` request parameter `authorization`, the type was generalized from `string` to no type
  - the `limit` request property default value changed from `1000` to `100`
  - added the optional property `documents` to the response with the `200` status
  - added the optional property `folder_counts` to the response with the `200` status
  - added the optional property `has_more` to the response with the `200` status
  - added the optional property `next_skip` to the response with the `200` status
  - added the optional property `status_counts` to the response with the `200` status
  - added the optional property `total_count` to the response with the `200` status
  - added the required property `limit` to the response with the `200` status
  - added the required property `returned_count` to the response with the `200` status
  - added the required property `skip` to the response with the `200` status
- **2025-12-18** `4b79c3821a17`: 1 warning, 5 info
  - removed the optional property `items/storage_files` from the response with the `200` status
  - added the optional property `items/folder_id` to the response with the `200` status
  - added the optional property `items/summary_bucket` to the response with the `200` status
  - added the optional property `items/summary_storage_key` to the response with the `200` status
  - added the optional property `items/summary_updated_at` to the response with the `200` status
  - added the optional property `items/summary_version` to the response with the `200` status
- **2025-12-06** `e185c542e939`: 2 info
  - added the new optional `query` request parameter `folder_depth`
  - added the optional property `items/folder_path` to the response with the `200` status
- **2025-11-27** `4ce03d9b0f27`: 1 info
  - the `limit` request property default value changed from `10000` to `1000`
- **2025-11-13** `b9ae748cb938`: 1 info
  - added the optional property `items/metadata_types` to the response with the `200` status
- **2025-11-05** `9ade02dd7b1d`: 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

---

[Operation](https://skmtc.dev/morphik-org/apis/morphik-api/docs/documents/post.md) - [API](https://skmtc.dev/morphik-org/apis/morphik-api.md) - [Page](https://skmtc.dev/morphik-org/apis/morphik-api/changes/documents/post)