---
title: "Changes to POST /agreements/{agreement_id}/versions"
method: POST
path: "/agreements/{agreement_id}/versions"
---

# Changes to POST /agreements/{agreement_id}/versions

`POST /agreements/{agreement_id}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 12 revisions.

- **2025-05-17** `2de715cbd1f3`: 3 breaking, 11 info
- **2023-12-01** `22a697bcb678`: 3 breaking, 11 warning
- **2022-12-08** `86adefb0bb29`: 3 breaking, 11 info
- **2022-06-30** `6118e3620603`: 2 breaking, 11 warning, 1 info
- **2021-09-27** `690ac65fe824`: 1 info

## Changes

- **2025-05-17** `2de715cbd1f3`: 3 breaking, 11 info
  - added the new required request property `document_type`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `201`
  - added the new optional request property `active`
  - added the new optional request property `file`
  - added the new optional request property `link`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `active` to the response with the `201` status
  - added the optional property `agreement` to the response with the `201` status
  - added the optional property `author` to the response with the `201` status
  - added the optional property `link` to the response with the `201` status
  - added the optional property `version` to the response with the `201` status
  - added the optional property `version_contracts` to the response with the `201` status
  - added the optional property `version_created` to the response with the `201` status
- **2023-12-01** `22a697bcb678`: 3 breaking, 11 warning
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `201`
  - removed the media type `application/json` for the response with the status `400`
  - removed the request property `active`
  - removed the request property `document_type`
  - removed the request property `file`
  - removed the request property `link`
  - removed the optional property `active` from the response with the `201` status
  - removed the optional property `agreement` from the response with the `201` status
  - removed the optional property `author` from the response with the `201` status
  - removed the optional property `link` from the response with the `201` status
  - removed the optional property `version` from the response with the `201` status
  - removed the optional property `version_contracts` from the response with the `201` status
  - removed the optional property `version_created` from the response with the `201` status
- **2022-12-08** `86adefb0bb29`: 3 breaking, 11 info
  - added the new required request property `document_type`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `201`
  - added the new optional request property `active`
  - added the new optional request property `file`
  - added the new optional request property `link`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `active` to the response with the `201` status
  - added the optional property `agreement` to the response with the `201` status
  - added the optional property `author` to the response with the `201` status
  - added the optional property `link` to the response with the `201` status
  - added the optional property `version` to the response with the `201` status
  - added the optional property `version_contracts` to the response with the `201` status
  - added the optional property `version_created` to the response with the `201` status
- **2022-06-30** `6118e3620603`: 2 breaking, 11 warning, 1 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `201`
  - removed the request property `active`
  - removed the request property `document_type`
  - removed the request property `file`
  - removed the request property `link`
  - removed the optional property `active` from the response with the `201` status
  - removed the optional property `agreement` from the response with the `201` status
  - removed the optional property `author` from the response with the `201` status
  - removed the optional property `link` from the response with the `201` status
  - removed the optional property `version` from the response with the `201` status
  - removed the optional property `version_contracts` from the response with the `201` status
  - removed the optional property `version_created` from the response with the `201` status
  - api operation id `agreement_versions_list_createAgreementVersionCreate` removed and replaced with `dp_agreement_versions_list_createAgreementVersion`
- **2021-09-27** `690ac65fe824`: 1 info
  - added the optional property `agreement/owner/icon` to the response with the `201` status

---

[Operation](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/docs/agreements/:agreement_id/versions/post.md) - [API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) - [Page](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/changes/agreements/:agreement_id/versions/post)