---
title: "Changes to POST /agreements"
method: POST
path: "/agreements"
---

# Changes to POST /agreements

`POST /agreements`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 12 revisions.

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

## Changes

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 21 info
  - the response's body type changed from no type to `object` for status `201`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `auto_accept` to the response with the `201` status
  - added the optional property `created` to the response with the `201` status
  - added the optional property `document_type` to the response with the `201` status
  - added the optional property `events` to the response with the `201` status
  - added the optional property `forms` to the response with the `201` status
  - added the optional property `id` to the response with the `201` status
  - added the optional property `owner` to the response with the `201` status
  - added the optional property `parent` to the response with the `201` status
  - added the optional property `sourcing_agreement` to the response with the `201` status
  - added the optional property `stats` to the response with the `201` status
  - added the optional property `title` to the response with the `201` status
  - added the optional property `type` to the response with the `201` status
  - added the optional property `updated` to the response with the `201` status
  - added the optional property `version` to the response with the `201` status
  - added the optional write-only property `active` to the response with the `201` status
  - added the optional write-only property `file` to the response with the `201` status
  - added the optional write-only property `link` to the response with the `201` status
  - added the required property `description` to the response with the `201` status
  - added the required property `marketplace` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
- **2023-12-01** `22a697bcb678`: 10 breaking, 22 warning, 13 info
  - the request property `file` became not nullable
  - removed the enum value `none` of the request property `document_type`
  - removed the enum value `referral` of the request property `type`
  - removed the enum value `syndication` of the request property `type`
  - removed the enum value `uploaded` of the request property `document_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 required property `description` from the response with the `201` status
  - removed the required property `marketplace` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the request property `auto_accept`
  - removed the request property `forms`
  - removed the request property `marketplace`
  - removed the request property `name`
  - removed the request property `owner`
  - removed the request property `parent`
  - removed the request property `sourcing_agreement`
  - removed the request property `version`
  - removed the optional property `auto_accept` from the response with the `201` status
  - removed the optional property `created` from the response with the `201` status
  - removed the optional property `document_type` from the response with the `201` status
  - removed the optional property `events` from the response with the `201` status
  - removed the optional property `forms` from the response with the `201` status
  - removed the optional property `id` from the response with the `201` status
  - removed the optional property `owner` from the response with the `201` status
  - removed the optional property `parent` from the response with the `201` status
  - removed the optional property `sourcing_agreement` from the response with the `201` status
  - removed the optional property `stats` from the response with the `201` status
  - removed the optional property `title` from the response with the `201` status
  - removed the optional property `type` from the response with the `201` status
  - removed the optional property `updated` from the response with the `201` status
  - removed the optional property `version` from the response with the `201` status
  - added the new optional request property `sourcing`
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - the request optional property `active` became not write-only
  - the request optional property `file` became not write-only
  - the request optional property `link` became not write-only
  - the request property `description` became optional
  - the `document_type` request property default value `external` was removed
  - added the new `product` enum value to the request property `type`
  - …5 more
- **2022-12-08** `86adefb0bb29`: 5 breaking, 33 info
  - added the new required request property `description`
  - added the new required request property `marketplace`
  - added the new required request property `name`
  - 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 `auto_accept`
  - added the new optional request property `document_type`
  - added the new optional request property `file`
  - added the new optional request property `forms`
  - added the new optional request property `link`
  - added the new optional request property `owner`
  - added the new optional request property `parent`
  - added the new optional request property `sourcing_agreement`
  - added the new optional request property `title`
  - added the new optional request property `type`
  - added the new optional request property `version`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `auto_accept` to the response with the `201` status
  - added the optional property `created` to the response with the `201` status
  - added the optional property `document_type` to the response with the `201` status
  - added the optional property `events` to the response with the `201` status
  - added the optional property `forms` to the response with the `201` status
  - added the optional property `id` to the response with the `201` status
  - added the optional property `owner` to the response with the `201` status
  - added the optional property `parent` to the response with the `201` status
  - added the optional property `sourcing_agreement` to the response with the `201` status
  - added the optional property `stats` to the response with the `201` status
  - added the optional property `title` to the response with the `201` status
  - added the optional property `type` to the response with the `201` status
  - added the optional property `updated` to the response with the `201` status
  - added the optional property `version` to the response with the `201` status
  - added the optional write-only property `active` to the response with the `201` status
  - added the optional write-only property `file` to the response with the `201` status
  - added the optional write-only property `link` to the response with the `201` status
  - added the required property `description` to the response with the `201` status
  - added the required property `marketplace` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
- **2022-06-30** `6118e3620603`: 5 breaking, 20 warning, 3 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 required property `description` from the response with the `201` status
  - removed the required property `title` from the response with the `201` status
  - removed the required property `type` from the response with the `201` status
  - removed the request property `active`
  - removed the request property `auto_accept`
  - removed the request property `description`
  - removed the request property `document_type`
  - removed the request property `file`
  - removed the request property `link`
  - removed the request property `marketplace`
  - removed the request property `parent`
  - removed the request property `title`
  - removed the request property `type`
  - removed the optional property `auto_accept` from the response with the `201` status
  - removed the optional property `created` from the response with the `201` status
  - removed the optional property `forms` from the response with the `201` status
  - removed the optional property `id` from the response with the `201` status
  - removed the optional property `marketplace` from the response with the `201` status
  - removed the optional property `owner` from the response with the `201` status
  - removed the optional property `parent` from the response with the `201` status
  - removed the optional property `stats` from the response with the `201` status
  - removed the optional property `updated` from the response with the `201` status
  - removed the optional property `version` from the response with the `201` status
  - api operation id `agreement_list_createAgreementCreate` removed and replaced with `dp_agreement_list_createAgreement`
  - removed the optional write-only property `active` from the response with the `201` status
  - removed the required write-only property `link` from the response with the `201` status
- **2021-09-27** `690ac65fe824`: 1 warning, 1 info
  - removed the optional property `agreements` from the response with the `201` status
  - added the optional property `owner/icon` to the response with the `201` status

---

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