---
title: "Changes to Create a new version"
method: POST
path: "/v1beta/documents/{document_id}/versions"
---

# Changes to Create a new version

`POST /v1beta/documents/{document_id}/versions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 50 revisions.

- **2026-03-16** `cb42a69ce465` — 2 breaking
- **2026-03-05** `a7e69986914e` — 2 warning, 4 info

## Changes

- **2026-03-16** `cb42a69ce465` — 2 breaking
  - the request property `description` became not nullable
  - the request property `title` became not nullable
- **2026-03-05** `a7e69986914e` — 2 warning, 4 info
  - added the new `bot` enum value to the `created_by/type` response property for the response status `200`
  - added the new `user` enum value to the `created_by/type` response property for the response status `200`
  - added discriminator to `created_by` response property for the response status `200`
  - removed the `service_account` enum value from the `created_by/type` response property for the response status `200`
  - removed the `user_account` enum value from the `created_by/type` response property for the response status `200`
  - the `created_by/id` response's property pattern was changed from `^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$` to `^(user|bot)_[0-9a-hjkmnp-tv-z]{26}$` for the status `200`

---

[Operation](https://skmtc.dev/factify-inc/apis/factify-api/docs/v1beta/documents/:document_id/versions/post.md) · [API](https://skmtc.dev/factify-inc/apis/factify-api.md) · [Page](https://skmtc.dev/factify-inc/apis/factify-api/changes/v1beta/documents/:document_id/versions/post)