Use this endpoint to create a new draft version of a proposal that has already been sent. The new draft is a fresh copy of the source proposal in the same proposal series, with a new UUID, and the request body lets you override fields on the new draft. For partial in-place updates of a draft you have not sent yet, use Patch proposal (draft). For an entirely new proposal series, use Create proposal.
Proposal exists and is still draft or template → PATCH /v3/proposals/{uuid} (in-place update, same UUID).
Proposal exists and has already been sent (active, accepted, replaced, expired, or rejected) → this endpoint (POST /v3/proposals/{uuid}) — it creates a new draft version in the same proposal series.
Calling this endpoint while the source proposal is still a draft is allowed, but it creates a separate draft alongside the existing one rather than a true new version. For changes to a proposal you have not yet sent, prefer PATCH /v3/proposals/{uuid}.
Calling this endpoint repeatedly for the same source UUID returns the same draft UUID until that draft is sent or archived. Each call applies your latest body to that draft, so callers should treat this endpoint as “create-or-replace the next-version draft” rather than “always create a new draft”. Once the draft is sent (or archived), a subsequent call mints a fresh new-version draft.
The new draft inherits the following from the source proposal, unless overridden in the request body:
Blocks, including any title, description, and image customisations made in the editor
Attachments
Recipient
Language
Title and description
Tax options
Discount badge decimals (discount_decimals)
Background image and background video
Payment configuration
Proposal metadata (data)
Creator and contact person
The new draft belongs to the same proposal series as the source. When the series contains a previously accepted proposal, the new draft is automatically linked to it so version history is preserved in the editor.
The body shape mirrors Create proposal; most fields are optional and override the value carried over from the source, but company_id and language are required (see Eligibility). The body is strict — extra keys return 400 with error.issues describing each problem.
creator_email is ignored on this route. The creator is preserved from the previous version.
Same shape as Create proposal. An id must be an active contact in the proposal’s company; an archived contact is accepted only when it is already the recipient. Otherwise the request returns 400 with error.code: "INVALID_RECIPIENT" and no new version is created.
How many decimals the discount badge on a product shows, as on Create proposal. Overrides the carried-over value; when omitted, the new draft keeps the source proposal’s setting, not the company’s current one.
The UUID of the new draft version (always different from the path UUID; the same draft UUID is returned on repeated calls until that draft is sent or archived — see Idempotency).
New draft version created (or existing one returned and updated under the idempotency rule).
400
Body validation failed (response includes error.issues with per-field details), or recipient.id is not an active contact in the company (error.code: "INVALID_RECIPIENT").
401
Missing or invalid API token.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Proposales","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"favicon":"https://mintcdn.com/proposalesab/-5otOw2eXOA6LlgK/favicon.png?fit=max\u0026auto=format\u0026n=-5otOw2eXOA6LlgK\u0026q=85\u0026s=408ef645c944c9d8047d2a02c4cdc176","logo":{"light":"https://assets-global.website-files.com/64fa70d89846f59218c2ffad/660f4f0d82b47dda8b055665_logo-without%20trademark.svg","dark":"https://assets-global.website-files.com/64fa70d89846f59218c2ffad/660f4f1aa9f94598aa2bc011_logo-light-without-trademark.svg"},"api":{"openapi":"openapi.json","mdx":{"server":"https://api.proposales.com","auth":{"method":"bearer","name":null}}},"appearance":{"default":"dark","strict":true},"background":{"decoration":null,"color":{"light":"#000000","dark":"#000000"}},"navbar":{"links":[],"primary":{"type":"button","label":"Sign up","href":"https://proposales.com/signup"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"proposalesab","hasAudioNarration":false,"actualSubdomain":"proposalesab","customDomains":["docs.proposales.com"],"gitSource":{"type":"github","owner":"proposales","repo":"proposales","deployBranch":"develop","contentDirectory":"packages/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aec8a13f73278e02598da5d","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":26},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Entities","count":8},{"language":"default","tag":"Content","count":7},{"language":"default","tag":"Proposals","count":7},{"language":"default","tag":"Companies","count":2},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"Attachments","count":1},{"language":"default","tag":"API Documentation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/proposals/new-version","slug":"/api-reference/proposals/new-version","pageMetadata":{"title":"Create new version of proposal","api":"POST /v3/proposals/{uuid}","description":"Create a new draft version of an existing proposal in the same proposal series.","href":"/api-reference/proposals/new-version"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new draft version of an existing proposal in the same proposal series.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint to create a new draft `,_jsx(_components.strong,{children:`version`}),` of a proposal that has already been sent. The new draft is a fresh copy of the source proposal in the same proposal series, with a new UUID, and the request body lets you override fields on the new draft. For partial in-place updates of a draft you have not sent yet, use `,_jsx(_components.a,{href:`/api-reference/proposals/patch-draft`,children:_jsx(_components.code,{children:`Patch proposal (draft)`})}),`. For an entirely new proposal series, use `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:_jsx(_components.code,{children:`Create proposal`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-this-endpoint`,children:`When to use this endpoint`}),`\n`,_jsx(_components.p,{children:`Pick the right v3 endpoint based on the current state of the proposal on Proposales’ side:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Proposal does not exist yet`}),` → `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:_jsx(_components.code,{children:`POST /v3/proposals`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Proposal exists and is still `,_jsx(_components.code,{children:`draft`}),` or `,_jsx(_components.code,{children:`template`})]}),` → `,_jsx(_components.a,{href:`/api-reference/proposals/patch-draft`,children:_jsx(_components.code,{children:`PATCH /v3/proposals/{uuid}`})}),` (in-place update, same UUID).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Proposal exists and has already been sent`}),` (`,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`accepted`}),`, `,_jsx(_components.code,{children:`replaced`}),`, `,_jsx(_components.code,{children:`expired`}),`, or `,_jsx(_components.code,{children:`rejected`}),`) → this endpoint (`,_jsx(_components.code,{children:`POST /v3/proposals/{uuid}`}),`) — it creates a new draft version in the same proposal series.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Calling this endpoint while the source proposal is still a `,_jsx(_components.code,{children:`draft`}),` is allowed, but it creates a `,_jsx(_components.em,{children:`separate`}),` draft alongside the existing one rather than a true new version. For changes to a proposal you have not yet sent, prefer `,_jsx(_components.a,{href:`/api-reference/proposals/patch-draft`,children:_jsx(_components.code,{children:`PATCH /v3/proposals/{uuid}`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`eligibility`,children:`Eligibility`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The source proposal must exist.`}),`\n`,_jsx(_components.li,{children:`The caller must have access to the source proposal’s company.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`body.company_id`}),` must match the source proposal’s company.`]}),`\n`,_jsxs(_components.li,{children:[`The source proposal must `,_jsx(_components.strong,{children:`not`}),` be `,_jsx(_components.code,{children:`withdrawn`}),`. Any other status is accepted (`,_jsx(_components.code,{children:`draft`}),`, `,_jsx(_components.code,{children:`template`}),`, `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`accepted`}),`, `,_jsx(_components.code,{children:`replaced`}),`, `,_jsx(_components.code,{children:`expired`}),`, `,_jsx(_components.code,{children:`rejected`}),`).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`idempotency`,children:`Idempotency`}),`\n`,_jsxs(_components.p,{children:[`Calling this endpoint repeatedly for the same source UUID returns the `,_jsx(_components.strong,{children:`same`}),` draft UUID until that draft is sent or archived. Each call applies your latest body to that draft, so callers should treat this endpoint as “create-or-replace the next-version draft” rather than “always create a new draft”. Once the draft is sent (or archived), a subsequent call mints a fresh new-version draft.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-carries-over-from-the-source`,children:`What carries over from the source`}),`\n`,_jsx(_components.p,{children:`The new draft inherits the following from the source proposal, unless overridden in the request body:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Blocks, including any title, description, and image customisations made in the editor`}),`\n`,_jsx(_components.li,{children:`Attachments`}),`\n`,_jsx(_components.li,{children:`Recipient`}),`\n`,_jsx(_components.li,{children:`Language`}),`\n`,_jsx(_components.li,{children:`Title and description`}),`\n`,_jsx(_components.li,{children:`Tax options`}),`\n`,_jsxs(_components.li,{children:[`Discount badge decimals (`,_jsx(_components.code,{children:`discount_decimals`}),`)`]}),`\n`,_jsx(_components.li,{children:`Background image and background video`}),`\n`,_jsx(_components.li,{children:`Payment configuration`}),`\n`,_jsxs(_components.li,{children:[`Proposal metadata (`,_jsx(_components.code,{children:`data`}),`)`]}),`\n`,_jsx(_components.li,{children:`Creator and contact person`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The new draft belongs to the `,_jsx(_components.strong,{children:`same proposal series`}),` as the source. When the series contains a previously accepted proposal, the new draft is automatically linked to it so version history is preserved in the editor.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path`,children:`Path`}),`\n`,_jsx(ParamField,{path:`uuid`,type:`uuid`,required:true,id:`param-uuid`,children:_jsx(_components.p,{children:`The UUID of the source proposal to create a new version from.`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(_components.p,{children:[`The body shape mirrors `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:_jsx(_components.code,{children:`Create proposal`})}),`; most fields are `,_jsx(_components.strong,{children:`optional`}),` and override the value carried over from the source, but `,_jsx(_components.code,{children:`company_id`}),` and `,_jsx(_components.code,{children:`language`}),` are `,_jsx(_components.strong,{children:`required`}),` (see `,_jsx(_components.a,{href:`#eligibility`,children:`Eligibility`}),`). The body is `,_jsx(_components.strong,{children:`strict`}),` — extra keys return `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`400`})}),` with `,_jsx(_components.code,{children:`error.issues`}),` describing each problem.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`creator_email`})}),` is `,_jsx(_components.strong,{children:`ignored`}),` on this route. The creator is preserved from the previous version.`]}),`\n`]}),`\n`,_jsx(ParamField,{body:`company_id`,type:`number`,required:true,id:`param-company-id`,children:_jsxs(_components.p,{children:[`Must equal the source proposal’s `,_jsx(_components.code,{children:`company_id`}),`.`]})}),`\n`,_jsx(ParamField,{body:`language`,type:`string`,required:true,id:`param-language`,children:_jsxs(_components.p,{children:[`ISO-style language code (e.g. `,_jsx(_components.code,{children:`en`}),`, `,_jsx(_components.code,{children:`sv`}),`).`]})}),`\n`,_jsx(ParamField,{body:`title_md`,type:`string`,id:`param-title-md`,children:_jsx(_components.p,{children:`Proposal title as Markdown. Overrides the carried-over title.`})}),`\n`,_jsx(ParamField,{body:`description_md`,type:`string`,id:`param-description-md`,children:_jsx(_components.p,{children:`Proposal description as Markdown. Overrides the carried-over description.`})}),`\n`,_jsx(ParamField,{body:`recipient`,type:`object`,id:`param-recipient`,children:_jsxs(_components.p,{children:[`Same shape as `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`. An `,_jsx(_components.code,{children:`id`}),` must be an active contact in the proposal’s company; an archived contact is accepted only when it is already the recipient. Otherwise the request returns `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`400`})}),` with `,_jsx(_components.code,{children:`error.code: \"INVALID_RECIPIENT\"`}),` and no new version is created.`]})}),`\n`,_jsx(ParamField,{body:`contact_email`,type:`string`,id:`param-contact-email`,children:_jsxs(_components.p,{children:[`Email of the internal contact person. Same rules as `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`.`]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,id:`param-data`,children:_jsxs(_components.p,{children:[`Proposal metadata. Replaces the carried-over `,_jsx(_components.code,{children:`data`}),`.`]})}),`\n`,_jsx(ParamField,{body:`blocks`,type:`array`,id:`param-blocks`,children:_jsxs(_components.p,{children:[`Same block shape as `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`. When provided, the array replaces the carried-over block list on the new draft.`]})}),`\n`,_jsx(ParamField,{body:`attachments`,type:`array`,id:`param-attachments`,children:_jsxs(_components.p,{children:[`Same attachment shapes as `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`. When provided, replaces the carried-over attachments.`]})}),`\n`,_jsx(ParamField,{body:`background_image`,type:`object`,id:`param-background-image`}),`\n`,_jsx(ParamField,{body:`background_video`,type:`object`,id:`param-background-video`}),`\n`,_jsx(ParamField,{body:`invoicing_enabled`,type:`boolean`,id:`param-invoicing-enabled`}),`\n`,_jsx(ParamField,{body:`invoicing`,type:`object`,id:`param-invoicing`}),`\n`,_jsx(ParamField,{body:`tax_options`,type:`object`,id:`param-tax-options`,children:_jsxs(_components.p,{children:[`Same shape as `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`.`]})}),`\n`,_jsx(ParamField,{body:`discount_decimals`,type:`0 | 1 | 2`,id:`param-discount-decimals`,children:_jsxs(_components.p,{children:[`How many decimals the discount badge on a product shows, as on `,_jsx(_components.a,{href:`/api-reference/proposals/create`,children:`Create proposal`}),`. Overrides the carried-over value; when omitted, the new draft keeps the source proposal’s setting, not the company’s current one.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`proposal`,type:`object`,id:`param-proposal`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`uuid`,type:`string`,id:`param-uuid-1`,children:_jsxs(_components.p,{children:[`The UUID of the new draft version (always different from the path UUID; the same draft UUID is returned on repeated calls until that draft is sent or archived — see `,_jsx(_components.a,{href:`#idempotency`,children:`Idempotency`}),`).`]})}),_jsx(ResponseField,{name:`url`,type:`string`,id:`param-url`,children:_jsx(_components.p,{children:`Editor URL for the new draft.`})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`status-codes`,children:`Status codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`New draft version created (or existing one returned and updated under the idempotency rule).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Body validation failed (response includes `,_jsx(_components.code,{children:`error.issues`}),` with per-field details), or `,_jsx(_components.code,{children:`recipient.id`}),` is not an active contact in the company (`,_jsx(_components.code,{children:`error.code: \"INVALID_RECIPIENT\"`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Missing or invalid API token.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create new version of proposal","api":"POST /v3/proposals/{uuid}","description":"Create a new draft version of an existing proposal in the same proposal series.","href":"/api-reference/proposals/new-version"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When to use this endpoint","slug":"when-to-use-this-endpoint","depth":2,"children":[]},{"title":"Eligibility","slug":"eligibility","depth":2,"children":[]},{"title":"Idempotency","slug":"idempotency","depth":2,"children":[]},{"title":"What carries over from the source","slug":"what-carries-over-from-the-source","depth":2,"children":[]},{"title":"Path","slug":"path","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Status codes","slug":"status-codes","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create new version of proposal","path":"/v3/proposals/{uuid}","servers":[{"url":"https://api.proposales.com"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"uuid":{"schema":[{"type":"string","description":"The UUID of the source proposal to create a new version from.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"company_id":[{"type":"number","description":"Must equal the source proposal’s `company_id` .","required":true}],"language":[{"type":"string","description":"ISO-style language code (e.g. `en` , `sv` ).","required":true}],"title_md":[{"type":"string","description":"Proposal title as Markdown. Overrides the carried-over title."}],"description_md":[{"type":"string","description":"Proposal description as Markdown. Overrides the carried-over description."}],"recipient":[{"type":"object","properties":{},"description":"Same shape as Create proposal . An `id` must be an active contact in the proposal’s company; an archived contact is accepted only when it is already the recipient. Otherwise the request returns `400` with `error.code: \"INVALID_RECIPIENT\"` and no new version is created."}],"contact_email":[{"type":"string","description":"Email of the internal contact person. Same rules as Create proposal ."}],"data":[{"type":"object","properties":{},"description":"Proposal metadata. Replaces the carried-over `data` ."}],"blocks":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Same block shape as Create proposal . When provided, the array replaces the carried-over block list on the new draft."}],"attachments":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Same attachment shapes as Create proposal . When provided, replaces the carried-over attachments."}],"background_image":[{"type":"object","properties":{}}],"background_video":[{"type":"object","properties":{}}],"invoicing_enabled":[{"type":"boolean"}],"invoicing":[{"type":"object","properties":{}}],"tax_options":[{"type":"object","properties":{},"description":"Same shape as Create proposal ."}],"discount_decimals":[{"type":"object","properties":{},"description":"How many decimals the discount badge on a product shows, as on Create proposal . Overrides the carried-over value; when omitted, the new draft keeps the source proposal’s setting, not the company’s current one."}]}}],"examples":{"example":{"value":{"company_id":123,"language":"\u003cstring>","title_md":"\u003cstring>","description_md":"\u003cstring>","recipient":{},"contact_email":"\u003cstring>","data":{},"blocks":[{}],"attachments":[{}],"background_image":{},"background_video":{},"invoicing_enabled":true,"invoicing":{},"tax_options":{},"discount_decimals":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"proposal":[{"type":"object","properties":{"uuid":[{"type":"string","description":"The UUID of the new draft version (always different from the path UUID; the same draft UUID is returned on repeated calls until that draft is sent or archived — see Idempotency )."}],"url":[{"type":"string","description":"Editor URL for the new draft."}]}}]}}],"examples":{"example":{"value":{"proposal":{"uuid":"\u003cstring>","url":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"proposalesab","siteName":"Proposales","title":"Create new version of proposal - Proposales","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T13:41:32.399Z","originalFileLocation":"api-reference/proposals/new-version.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new draft version of an existing proposal in the same proposal series.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Proposales\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create new version of proposal - Proposales\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new draft version of an existing proposal in the same proposal series.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Proposales\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.proposales.com/api-reference/proposals/new-version\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://proposalesab.mintlify.site/_mintlify/api/og/v2?division=Proposals\u0026amp;title=Create+new+version+of+proposal\u0026amp;description=Create+a+new+draft+version+of+an+existing+proposal+in+the+same+proposal+series.\u0026amp;theme=17929bb6a46c6ea3865b024e\u0026amp;signature=ee3b269824a57306cfdb5c24141cddbe661e0bbe7803c5d8661da31590a8ad58\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create new version of proposal - Proposales\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new draft version of an existing proposal in the same proposal series.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://proposalesab.mintlify.site/_mintlify/api/og/v2?division=Proposals\u0026amp;title=Create+new+version+of+proposal\u0026amp;description=Create+a+new+draft+version+of+an+existing+proposal+in+the+same+proposal+series.\u0026amp;theme=17929bb6a46c6ea3865b024e\u0026amp;signature=ee3b269824a57306cfdb5c24141cddbe661e0bbe7803c5d8661da31590a8ad58\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/proposalesab/pmwmJJ--lyoSQtMs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Proposales\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.proposales.com/api-reference/proposals/new-version\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/proposals/new-version.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.proposales.com/#organization\",\"name\":\"Proposales\",\"url\":\"https://docs.proposales.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets-global.website-files.com/64fa70d89846f59218c2ffad/660f4f0d82b47dda8b055665_logo-without%20trademark.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.proposales.com#website\",\"name\":\"Proposales\",\"url\":\"https://docs.proposales.com\",\"publisher\":{\"@id\":\"https://docs.proposales.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.proposales.com/api-reference/proposals/new-version#webpage\",\"url\":\"https://docs.proposales.com/api-reference/proposals/new-version\",\"name\":\"Create new version of proposal\",\"description\":\"Create a new draft version of an existing proposal in the same proposal series.\",\"dateModified\":\"2026-10-13T13:41:32.399Z\",\"isPartOf\":{\"@id\":\"https://docs.proposales.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.proposales.com/api-reference/proposals/new-version#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.proposales.com/api-reference/proposals/new-version#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Proposals\",\"item\":\"https://docs.proposales.com/api-reference/proposals/get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create new version of proposal\",\"item\":\"https://docs.proposales.com/api-reference/proposals/new-version\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.proposales.com/api-reference/proposals/new-version#apireference\",\"headline\":\"Create new version of proposal\",\"name\":\"Create new version of proposal\",\"description\":\"Create a new draft version of an existing proposal in the same proposal series.\",\"url\":\"https://docs.proposales.com/api-reference/proposals/new-version\",\"mainEntityOfPage\":{\"@id\":\"https://docs.proposales.com/api-reference/proposals/new-version#webpage\"},\"dateModified\":\"2026-10-13T13:41:32.399Z\",\"publisher\":{\"@id\":\"https://docs.proposales.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.proposales.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Proposales\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Proposales\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/proposals/new-version.md","siteName":"Proposales","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Entities","pages":[{"title":"Integration Field","href":"/api-reference/entities/integration-field"},{"title":"Integrations Session Data","href":"/api-reference/entities/integrations-session-data"},{"title":"Package Split","href":"/api-reference/entities/package-split"},{"title":"Proposal","href":"/api-reference/entities/proposal"},{"title":"Proposal Block","href":"/api-reference/entities/proposal-block"},{"title":"Multi-Product Row","href":"/api-reference/entities/multi-product-row"},{"title":"Proposal Attachment","href":"/api-reference/entities/proposal-attachment"},{"title":"Unit values","href":"/api-reference/entities/unit-values"}]},{"group":"Attachments","pages":[{"title":"List Attachments","api":"GET /v1/attachments","href":"/api-reference/attachments/list"}]},{"group":"Companies","pages":[{"title":"List Companies","api":"GET /v3/companies","href":"/api-reference/companies/list"},{"title":"List Company Templates","api":"GET /v3/companies/{companyId}/templates","href":"/api-reference/companies/[companyId]/templates"}]},{"group":"Content","pages":[{"title":"List Content","api":"GET /v3/content","href":"/api-reference/content/list"},{"title":"Create Content","api":"POST /v3/content","href":"/api-reference/content/create"},{"title":"Update Content","api":"PUT /v3/content","href":"/api-reference/content/update"},{"title":"Delete Content","api":"DELETE /v3/content","href":"/api-reference/content/delete"},{"title":"Bulk Archive Content","api":"DELETE /v3/content?action=bulk","href":"/api-reference/content/bulk-archive"},{"title":"Bulk Restore Content","api":"POST /v3/content?action=restore","href":"/api-reference/content/bulk-restore"},{"title":"Product IDs vs Variation IDs","href":"/api-reference/content/product-variation-ids"}]},{"group":"Proposals","pages":[{"title":"Get Proposal","api":"GET /v3/proposals/{uuid}","href":"/api-reference/proposals/get"},{"title":"Create Proposal","api":"POST /v3/proposals","description":"Create a new draft for a proposal.","href":"/api-reference/proposals/create"},{"title":"Create new version of proposal","api":"POST /v3/proposals/{uuid}","href":"/api-reference/proposals/new-version"},{"title":"Patch proposal (draft)","api":"PATCH /v3/proposals/{uuid}","description":"Partially update an existing draft or template proposal in place (same UUID).","href":"/api-reference/proposals/patch-draft"},{"title":"Patch Proposal Data","api":"PATCH /v3/proposals/{uuid}/data","href":"/api-reference/proposals/patch-data"},{"title":"Create an RFP","api":"POST /v1/inbox/[token]","href":"/api-reference/inbox/create-rfp"},{"title":"Proposal Search","api":"GET /v3/proposal-search","href":"/api-reference/proposals/search"}]}]},{"anchor":"Status","href":"https://status.proposales.com","icon":"signal-bars"},{"anchor":"Help","href":"https://help.proposales.com","icon":"book-open-cover"}]},"basePath":"","title":"Create new version of proposal - Proposales","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js"]}