{
"message": "A grace period can't be longer than 30 days",
"data": null
}
{
"message": "Invalid API key",
"data": null
}
{
"message": "Plan not found",
"data": null
}
Update a plan. Every field is editable, price and cadence included.
Changing a plan only affects new subscribers. Everyone already subscribed
keeps the terms copied onto their subscription when they signed up. To move
someone onto current pricing, call
Apply current plan terms.
Request authentication
This endpoint requires a Secret Key (sk_...).
Request parameters
Send only the fields you want to change.
string
What customers see on the plan.
number
The new price for new subscribers.
string
The fiat currency the plan is priced in.
string
day, week, month or year.
integer
Bill every N intervals.
integer
A free trial before the first charge.
integer
Days after a period ends that a subscriber can still pay. Between 0 and
30.
string
invoice only for now. auto_debit and both are coming soon.
Authorizations
x-api-key
string
header
required
Path Parameters
planId
string
required
Body
application/json
name
string
Example:
"Pro monthly"
description
string
amount
number
Example:
49
currency
string
default:USD
Example:
"USD"
interval
enum<string>
Available options:
day,
week,
month,
year
interval_count
integer
default:1
Example:
1
trial_days
integer
default:0
Example:
14
grace_days
integer
default:7
Days after a period ends that a subscriber can still pay before the subscription expires.
Required range: 0 <= x <= 30
Example:
7
collection_mode
enum<string>
default:invoice
Only invoice is accepted today. auto_debit (pull against an approved on-chain allowance) is coming soon; sending it is rejected.
Available options:
invoice
metadata
object
Response
The updated plan. Existing subscribers keep the terms they signed up on.
A single plan.
message
string
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Creptapay","colors":{"primary":"#3FC3DD","light":"#7FE4F6","dark":"#3FC3DD"},"logo":{"light":"https://mintcdn.com/creptapay/AH8V32c1FARYLJ8W/logo/light.svg?fit=max\u0026auto=format\u0026n=AH8V32c1FARYLJ8W\u0026q=85\u0026s=cc91572e5f51656b67ae65191454ba45","dark":"https://mintcdn.com/creptapay/AH8V32c1FARYLJ8W/logo/dark.svg?fit=max\u0026auto=format\u0026n=AH8V32c1FARYLJ8W\u0026q=85\u0026s=41a8af28730d2e3074b429bd29a51b74"},"favicon":"https://mintcdn.com/creptapay/AH8V32c1FARYLJ8W/favicon.svg?fit=max\u0026auto=format\u0026n=AH8V32c1FARYLJ8W\u0026q=85\u0026s=2307f50dc05a4ca188f8de2856665a55","appearance":{"default":"dark","strict":true},"background":{"decoration":"grid","color":{"light":"#0D0F1A","dark":"#0D0F1A"}},"navbar":{"links":[{"href":"mailto:support@creptapay.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.creptapay.com"}},"footer":{"socials":{"x":"https://x.com/creptapay","github":"https://github.com/CreptapayHq","linkedin":"https://linkedin.com/company/creptapay"}},"fonts":{"family":"DM Sans"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"creptapay","hasAudioNarration":false,"actualSubdomain":"creptapay","customDomains":["docs.creptapay.com"],"gitSource":{"type":"github","owner":"creptapayhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aed5c2f9b58911ecf79c549","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API reference","count":22},{"language":"default","tag":"Subscriptions","count":8},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Customers","count":5},{"language":"default","tag":"Plans","count":5},{"language":"default","tag":"Payments","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Plugins \u0026 SDKs","count":3},{"language":"default","tag":"Webhooks","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/plan/update-plan","slug":"/api-reference/plan/update-plan","pageMetadata":{"title":"Update Plan","openapi":"PATCH /plans/{planId}","description":"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.","href":"/api-reference/plan/update-plan"},"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: \"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Note,ResponseField}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Update a plan. Every field is editable, price and cadence included.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Changing a plan only affects `,_jsx(_components.strong,{children:`new`}),` subscribers. Everyone already subscribed\nkeeps the terms copied onto their subscription when they signed up. To move\nsomeone onto current pricing, call\n`,_jsx(_components.a,{href:`/api-reference/subscription/apply-plan-terms`,children:`Apply current plan terms`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request-authentication`,children:`Request authentication`}),`\n`,_jsxs(_components.p,{children:[`This endpoint requires a `,_jsx(_components.strong,{children:`Secret Key`}),` (`,_jsx(_components.code,{children:`sk_...`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-parameters`,children:`Request parameters`}),`\n`,_jsx(_components.p,{children:`Send only the fields you want to change.`}),`\n`,_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`What customers see on the plan.`})}),`\n`,_jsx(ResponseField,{name:`amount`,type:`number`,id:`param-amount`,children:_jsx(_components.p,{children:`The new price for new subscribers.`})}),`\n`,_jsx(ResponseField,{name:`currency`,type:`string`,id:`param-currency`,children:_jsx(_components.p,{children:`The fiat currency the plan is priced in.`})}),`\n`,_jsx(ResponseField,{name:`interval`,type:`string`,id:`param-interval`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`day`}),`, `,_jsx(_components.code,{children:`week`}),`, `,_jsx(_components.code,{children:`month`}),` or `,_jsx(_components.code,{children:`year`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`interval_count`,type:`integer`,id:`param-interval-count`,children:_jsx(_components.p,{children:`Bill every N intervals.`})}),`\n`,_jsx(ResponseField,{name:`trial_days`,type:`integer`,id:`param-trial-days`,children:_jsx(_components.p,{children:`A free trial before the first charge.`})}),`\n`,_jsx(ResponseField,{name:`grace_days`,type:`integer`,id:`param-grace-days`,children:_jsxs(_components.p,{children:[`Days after a period ends that a subscriber can still pay. Between `,_jsx(_components.code,{children:`0`}),` and\n`,_jsx(_components.code,{children:`30`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`collection_mode`,type:`string`,id:`param-collection-mode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`invoice`}),` only for now. `,_jsx(_components.code,{children:`auto_debit`}),` and `,_jsx(_components.code,{children:`both`}),` are `,_jsx(_components.strong,{children:`coming soon`}),`.`]})})]})}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":"Update Plan","openapi":"PATCH /plans/{planId}","description":"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.","href":"/api-reference/plan/update-plan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request authentication","slug":"request-authentication","depth":2,"children":[]},{"title":"Request parameters","slug":"request-parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update Plan","description":"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.","security":["a3186e81-a2b1-4c2d-bdcf-ed5fe0d64528"],"parameters":["2e351b5b-319d-4df5-8980-f2dde2c7d379"],"requestBody":"0395f8c7-3f52-4365-9af4-7a66a7a19cbb","responses":{"200":"6809f00d-3afe-44c8-b85c-8063d71032cc","400":"7a53eac0-8aa3-4196-98fd-7ddfcd2afde4","401":"beca5da0-63f6-4060-9fba-79758b3e918f","404":"6e24f823-2551-4acf-b854-c9938c64c0a9"},"method":"patch","type":"path","servers":["c5832537-a186-427e-b059-0212e7763ab2"],"path":"/plans/{planId}","baseUrlOptions":["https://api.creptapay.com/v1"],"title":"Update Plan","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2e351b5b-319d-4df5-8980-f2dde2c7d379":{"in":"path","name":"planId","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Pro monthly","uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"amount":{"type":"number","example":49,"uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","default":"USD","example":"USD","uniqueKey":"currency","typeLabel":"string"},"interval":{"type":"string","enum":["day","week","month","year"],"uniqueKey":"interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"integer","default":1,"example":1,"uniqueKey":"interval_count","typeLabel":"integer"},"trial_days":{"type":"integer","default":0,"example":14,"uniqueKey":"trial_days","typeLabel":"integer"},"grace_days":{"type":"integer","default":7,"minimum":0,"maximum":30,"example":7,"description":"Days after a period ends that a subscriber can still pay before the subscription expires.","uniqueKey":"grace_days","typeLabel":"integer"},"collection_mode":{"type":"string","enum":["invoice"],"default":"invoice","description":"Only `invoice` is accepted today. `auto_debit` (pull against an approved on-chain allowance) is coming soon; sending it is rejected.","uniqueKey":"collection_mode","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Pro monthly","description":"\u003cstring>","amount":49,"currency":"USD","interval_count":1,"trial_days":14,"grace_days":7,"collection_mode":"invoice","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6809f00d-3afe-44c8-b85c-8063d71032cc":{"description":"The updated plan. Existing subscribers keep the terms they signed up on.","content":{"application/json":{"schema":{"type":"object","description":"A single plan.","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"id":{"type":"string","example":"6712f0a1b9c4e2d3f4a5b6c7","uniqueKey":"data.id","typeLabel":"string"},"name":{"type":"string","example":"Pro monthly","uniqueKey":"data.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.description","typeLabel":"string | null"},"amount":{"type":"number","example":49,"uniqueKey":"data.amount","typeLabel":"number"},"currency":{"type":"string","example":"USD","uniqueKey":"data.currency","typeLabel":"string"},"interval":{"type":"string","enum":["day","week","month","year"],"uniqueKey":"data.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"integer","example":1,"uniqueKey":"data.interval_count","typeLabel":"integer"},"cadence":{"type":"string","description":"Human-readable cadence.","example":"every month","uniqueKey":"data.cadence","typeLabel":"string"},"trial_days":{"type":"integer","example":14,"uniqueKey":"data.trial_days","typeLabel":"integer"},"grace_days":{"type":"integer","description":"Days after a period ends that a subscriber can still pay.","example":7,"uniqueKey":"data.grace_days","typeLabel":"integer"},"allowed_currencies":{"type":"array","items":{"type":"string","uniqueKey":"data.allowed_currencies.items.[INDEX]","typeLabel":"string"},"example":["USDC"],"uniqueKey":"data.allowed_currencies","typeLabel":"string[]"},"collection_mode":{"type":"string","enum":["invoice","auto_debit","both"],"default":"invoice","description":"How renewals are collected. Only `invoice` can be set today; `auto_debit` and `both` are coming soon. A plan stored before that may still read back as `auto_debit`, and is collected by pay link until auto-debit ships.","uniqueKey":"data.collection_mode","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["active","archived"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Successfully updated plan","data":{"id":"6712f0a1b9c4e2d3f4a5b6c7","name":"Pro monthly","description":"Everything in Starter, plus priority support","amount":49,"currency":"USD","interval":"month","interval_count":1,"cadence":"every month","trial_days":14,"grace_days":7,"allowed_currencies":["USDC"],"collection_mode":"invoice","status":"active","metadata":null,"createdAt":"2026-01-15T09:22:11.000Z","updatedAt":"2026-01-15T09:22:11.000Z"}},"examples":{"Example":{"title":"Example","value":{"message":"Successfully updated plan","data":{"id":"6712f0a1b9c4e2d3f4a5b6c7","name":"Pro monthly","description":"Everything in Starter, plus priority support","amount":49,"currency":"USD","interval":"month","interval_count":1,"cadence":"every month","trial_days":14,"grace_days":7,"allowed_currencies":["USDC"],"collection_mode":"invoice","status":"active","metadata":null,"createdAt":"2026-01-15T09:22:11.000Z","updatedAt":"2026-01-15T09:22:11.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"7a53eac0-8aa3-4196-98fd-7ddfcd2afde4":{"description":"The request was rejected — a missing field, a value out of range, or an operation that isn't valid for the object's current state.","content":{"application/json":{"schema":{"type":"object","description":"Every failure comes back in this shape. `data` is always null.","properties":{"message":{"type":"string","description":"What went wrong, in plain words — safe to log, not to show a customer verbatim.","uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"example":null},{"example":null,"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"A grace period can't be longer than 30 days","data":null},"examples":{"Example":{"title":"Example","value":{"message":"A grace period can't be longer than 30 days","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"beca5da0-63f6-4060-9fba-79758b3e918f":{"description":"The API key is missing, malformed, or not valid for this environment.","content":{"application/json":{"schema":{"type":"object","description":"Every failure comes back in this shape. `data` is always null.","properties":{"message":{"type":"string","description":"What went wrong, in plain words — safe to log, not to show a customer verbatim.","uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"example":null},{"example":null,"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Invalid API key","data":null},"examples":{"Example":{"title":"Example","value":{"message":"Invalid API key","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"6e24f823-2551-4acf-b854-c9938c64c0a9":{"description":"No such object for this business and environment. A live key never sees sandbox objects, and vice versa.","content":{"application/json":{"schema":{"type":"object","description":"Every failure comes back in this shape. `data` is always null.","properties":{"message":{"type":"string","description":"What went wrong, in plain words — safe to log, not to show a customer verbatim.","uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"example":null},{"example":null,"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Plan not found","data":null},"examples":{"Example":{"title":"Example","value":{"message":"Plan not found","data":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a3186e81-a2b1-4c2d-bdcf-ed5fe0d64528":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"c5832537-a186-427e-b059-0212e7763ab2":{"url":"https://api.creptapay.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"creptapay","siteName":"Creptapay","title":"Update Plan - Creptapay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-26T17:27:13.669Z","originalFileLocation":"api-reference/plan/update-plan.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=\"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Creptapay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_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/creptapay/WHxmGYdKleXbjfba/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Plan - Creptapay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Creptapay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.creptapay.com/api-reference/plan/update-plan\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creptapay.mintlify.site/_mintlify/api/og/v2?division=Plans\u0026amp;title=Update+Plan\u0026amp;description=Update+a+plan%2C+price+and+cadence+included.+Existing+subscribers+keep+the+terms+they+signed+up+at.\u0026amp;theme=d2763859ebcd93245fd3c4ef\u0026amp;signature=dfc9dcee95fd6ae581167672ad057d0f1fd63fdbb6943bf960dbf77c3f21ce09\">\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=\"Update Plan - Creptapay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creptapay.mintlify.site/_mintlify/api/og/v2?division=Plans\u0026amp;title=Update+Plan\u0026amp;description=Update+a+plan%2C+price+and+cadence+included.+Existing+subscribers+keep+the+terms+they+signed+up+at.\u0026amp;theme=d2763859ebcd93245fd3c4ef\u0026amp;signature=dfc9dcee95fd6ae581167672ad057d0f1fd63fdbb6943bf960dbf77c3f21ce09\">\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/creptapay/WHxmGYdKleXbjfba/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Creptapay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3FC3DD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.creptapay.com/api-reference/plan/update-plan\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/plan/update-plan.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.creptapay.com/#organization\",\"name\":\"Creptapay\",\"url\":\"https://docs.creptapay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/creptapay/AH8V32c1FARYLJ8W/logo/light.svg?fit=max\u0026auto=format\u0026n=AH8V32c1FARYLJ8W\u0026q=85\u0026s=cc91572e5f51656b67ae65191454ba45\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.creptapay.com#website\",\"name\":\"Creptapay\",\"url\":\"https://docs.creptapay.com\",\"publisher\":{\"@id\":\"https://docs.creptapay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.creptapay.com/api-reference/plan/update-plan#webpage\",\"url\":\"https://docs.creptapay.com/api-reference/plan/update-plan\",\"name\":\"Update Plan\",\"description\":\"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\",\"dateModified\":\"2026-09-26T17:27:13.669Z\",\"isPartOf\":{\"@id\":\"https://docs.creptapay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creptapay.com/api-reference/plan/update-plan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creptapay.com/api-reference/plan/update-plan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Plans\",\"item\":\"https://docs.creptapay.com/api-reference/plan/create-plan\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update Plan\",\"item\":\"https://docs.creptapay.com/api-reference/plan/update-plan\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creptapay.com/api-reference/plan/update-plan#apireference\",\"headline\":\"Update Plan\",\"name\":\"Update Plan\",\"description\":\"Update a plan, price and cadence included. Existing subscribers keep the terms they signed up at.\",\"url\":\"https://docs.creptapay.com/api-reference/plan/update-plan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creptapay.com/api-reference/plan/update-plan#webpage\"},\"dateModified\":\"2026-09-26T17:27:13.669Z\",\"publisher\":{\"@id\":\"https://docs.creptapay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.creptapay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Creptapay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Creptapay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/plan/update-plan.md","siteName":"Creptapay","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction"}]},{"tab":"API reference","groups":[{"group":"Payments","pages":[{"title":"Create Payment","openapi":"POST /payment","href":"/api-reference/payment/create-payment"},{"title":"List Payments","openapi":"GET /payment","href":"/api-reference/payment/list-payments"},{"title":"Get Payment","openapi":"GET /payment/{id}","href":"/api-reference/payment/get-payment"},{"title":"Get Payment by Reference","openapi":"GET /payment/reference/{reference}","href":"/api-reference/payment/get-payment-by-reference"}]},{"group":"Customers","pages":[{"title":"Create Customer","openapi":"POST /customer","href":"/api-reference/customer/create-customer"},{"title":"List Customers","openapi":"GET /customer","href":"/api-reference/customer/list-customers"},{"title":"Get Customer","openapi":"GET /customer/{id}","href":"/api-reference/customer/get-customer"},{"title":"Update Customer","openapi":"PUT /customer/{id}","href":"/api-reference/customer/update-customer"},{"title":"Delete Customer","openapi":"DELETE /customer/{id}","href":"/api-reference/customer/delete-customer"}]},{"group":"Plans","pages":[{"title":"Create Plan","openapi":"POST /plans","href":"/api-reference/plan/create-plan"},{"title":"List Plans","openapi":"GET /plans","href":"/api-reference/plan/list-plans"},{"title":"Get Plan","openapi":"GET /plans/{planId}","description":null,"href":"/api-reference/plan/get-plan"},{"title":"Update Plan","openapi":"PATCH /plans/{planId}","href":"/api-reference/plan/update-plan"},{"title":"Archive Plan","openapi":"DELETE /plans/{planId}","description":"Stops new sign-ups. Existing subscriptions keep billing on their own terms.","href":"/api-reference/plan/archive-plan"}]},{"group":"Subscriptions","pages":[{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/subscription/create-subscription"},{"title":"List Subscriptions","openapi":"GET /subscriptions","href":"/api-reference/subscription/list-subscriptions"},{"title":"Subscription Metrics","openapi":"GET /subscriptions/summary","href":"/api-reference/subscription/subscription-metrics"},{"title":"Get Subscription","openapi":"GET /subscriptions/{subscriptionId}","href":"/api-reference/subscription/get-subscription"},{"title":"Cancel Subscription","openapi":"POST /subscriptions/{subscriptionId}/cancel","href":"/api-reference/subscription/cancel-subscription"},{"title":"Pause Subscription","openapi":"POST /subscriptions/{subscriptionId}/pause","href":"/api-reference/subscription/pause-subscription"},{"title":"Resume Subscription","openapi":"POST /subscriptions/{subscriptionId}/resume","href":"/api-reference/subscription/resume-subscription"},{"title":"Apply Current Plan Terms","openapi":"POST /subscriptions/{subscriptionId}/apply-plan-terms","href":"/api-reference/subscription/apply-plan-terms"}]}]}]},"basePath":"","title":"Update Plan - Creptapay","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}