--- title: "Changes to Create a proposal" method: POST path: "/api/v2/proposals" --- # Changes to Create a proposal `POST /api/v2/proposals` > Every recorded change to this operation, newest first. ## Timeline Changed in 4 of 49 revisions. - **2026-11-02** `fa3060fd0144`: 3 warning, 7 info - **2026-10-27** `f11a8740641a`: 17 breaking, 1 warning, 72 info - **2026-10-02** `5f834ea481fc`: 3 breaking - **2026-09-02** `061c271b2e3a`: 2 warning, 1 info ## Changes - **2026-11-02** `fa3060fd0144`: 3 warning, 7 info - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422` - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422` - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `406` - added the non-success response with the status `408` - added the non-success response with the status `423` - added the non-success response with the status `429` - added the non-success response with the status `500` - **2026-10-27** `f11a8740641a`: 17 breaking, 1 warning, 72 info - the `data/attributes/currency` response's property type changed from `string` to no type for status `201` - the `data/attributes/custom_fields` response's property type changed from `object` to no type for status `201` - the `data/attributes/date` response's property type changed from `string` to no type, and format from `date` to no format for status `201` - the `data/attributes/disclaimer` response's property type changed from `string` to no type for status `201` - the `data/attributes/end_date` response's property type changed from `string` to no type, and format from `date` to no format for status `201` - the `data/attributes/exchange_date` response's property type changed from `string` to no type, and format from `date` to no format for status `201` - the `data/attributes/exchange_rate` response's property type changed from `number` to `string` for status `201` - the `data/attributes/identity_confirmed_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201` - the `data/attributes/note` response's property type changed from `string` to no type for status `201` - the `data/attributes/number` response's property type changed from `string` to no type for status `201` - the `data/attributes/pdf_url` response's property type changed from `string` to no type for status `201` - the `data/attributes/purchase_order_number` response's property type changed from `string` to no type for status `201` - the `data/attributes/responder_email` response's property type changed from `string` to no type for status `201` - the `data/attributes/responder_name` response's property type changed from `string` to no type for status `201` - the `data/attributes/sent_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201` - the `data/attributes/signed_pdf_url` response's property type changed from `string` to no type for status `201` - the `data/attributes/status_changed_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201` - deleted the `header` request parameter `X-Organization-Id` - added the non-success response with the status `422` - added the optional property `data/attributes/source` to the response with the `201` status - added the optional property `data/relationships/attachment` to the response with the `201` status - added the optional property `data/relationships/scenario` to the response with the `201` status - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/client` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/contact` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/creator` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/deal` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/deal_creator` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/document_type` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/organization` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/project` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/proposal_from` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/proposal_to` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/responsible` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/subsidiary` response property `anyOf` list for the response status `201` - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/tax_rate` response property `anyOf` list for the response status `201` - added `#/components/schemas/currency, subschema #2` to the `data/attributes/currency` response property `anyOf` list for the response status `201` - added `#/components/schemas/custom_fields, subschema #2` to the `data/attributes/custom_fields` response property `anyOf` list for the response status `201` - added `#/components/schemas/date, subschema #2` to the `data/attributes/date` response property `anyOf` list for the response status `201` - added `#/components/schemas/disclaimer, subschema #2` to the `data/attributes/disclaimer` response property `anyOf` list for the response status `201` - added `#/components/schemas/end_date, subschema #2` to the `data/attributes/end_date` response property `anyOf` list for the response status `201` - …50 more - …this revision’s changelog is incomplete - **2026-10-02** `5f834ea481fc`: 3 breaking - the response property `data/attributes/identity_confirmed_at` became nullable for the status `201` - the `data/attributes/identity_confirmation_enabled` response's property type changed from no type to `boolean` for status `201` - the `data/attributes/identity_confirmed_at` response's property type changed from no type to `string`, and format from no format to `date-time` for status `201` - **2026-09-02** `061c271b2e3a`: 2 warning, 1 info - removed the optional property `data/attributes/audit_pdf_url` from the response with the `201` status - removed the optional property `data/attributes/original_pdf_url` from the response with the `201` status - added the optional property `data/attributes/number` to the response with the `201` status --- [Operation](https://skmtc.dev/productive/apis/api-documentation/docs/api/v2/proposals/post.md) - [API](https://skmtc.dev/productive/apis/api-documentation.md) - [Page](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/proposals/post)