{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PostMesh","description":"How PostMesh works: write one post, check it against every network's rules, and publish or schedule it to 12 social networks.","colors":{"primary":"#4A6400","light":"#D4FF5A","dark":"#4A6400"},"logo":{"light":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/light.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=c13168a50d17ec8f05a48af736f712b5","dark":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/dark.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=afac489a8efcd10bd280213baef858cb","href":"https://postmesh.app"},"favicon":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/favicon.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=69a8d816d5039e88c91fb6d1f5d21933","appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"href":"https://postmesh.app/pricing","label":"Pricing"},{"href":"https://postmesh.app/support","label":"Support"}],"primary":{"type":"button","label":"Start 7-day trial","href":"https://postmesh.app/signup"}},"footer":{"socials":{"discord":"https://discord.com/invite/wYh5fTVEFs"},"links":[{"header":"PostMesh","items":[{"label":"Home","href":"https://postmesh.app"},{"label":"Pricing","href":"https://postmesh.app/pricing"},{"label":"Support","href":"https://postmesh.app/support"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://postmesh.app/legal/privacy"},{"label":"Terms","href":"https://postmesh.app/legal/terms"},{"label":"Data deletion","href":"https://postmesh.app/legal/data-deletion"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"og:site_name":"PostMesh","og:image":"https://postmesh.app/brand/social-card.png","twitter:card":"summary_large_image"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"post-mesh","hasAudioNarration":false,"actualSubdomain":"post-mesh","customDomains":["postmesh.app"],"gitSource":{"type":"github","owner":"foundrceo","repo":"postmesh","deployBranch":"main","contentDirectory":"mintlify","isPrivate":false,"mountPath":"","label":"","_id":"6adde4c7ae0dc487a60fb07d"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeaa73822b64b3f9ae937ee","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API reference","count":20},{"language":"default","tag":"Posts","count":7},{"language":"default","tag":"Automate","count":6},{"language":"default","tag":"Publishing","count":6},{"language":"default","tag":"Drafts","count":5},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Media","count":4},{"language":"default","tag":"Account","count":2},{"language":"default","tag":"Networks","count":2},{"language":"default","tag":"Accounts","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/drafts/change-a-draft","slug":"/api-reference/drafts/change-a-draft","pageMetadata":{"title":"Change a draft","description":"Changes the fields you send and keeps the rest.\n\nNeeds an API key with the `drafts` scope.","deprecated":null,"version":null,"openapi":"/openapi.json patch /drafts/{id}","href":"/api-reference/drafts/change-a-draft","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Changes the fields you send and keeps the rest.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Needs an API key with the \", _jsx(_components.code, {\n children: \"drafts\"\n }), \" scope.\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Change a draft","description":"Changes the fields you send and keeps the rest.\n\nNeeds an API key with the `drafts` scope.","deprecated":null,"version":null,"openapi":"/openapi.json patch /drafts/{id}","href":"/api-reference/drafts/change-a-draft","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"updateDraft","summary":"Change a draft","description":"Changes the fields you send and keeps the rest.\n\nNeeds an API key with the `drafts` scope.","tags":["Drafts"],"x-postmesh-scope":"drafts","parameters":["30839070-d5d0-4fe4-af0f-a841eb88f8d9"],"requestBody":"22962750-632b-4eac-9f2b-fbace71dcb9e","responses":{"200":"d6cb094e-cd8d-45f8-8369-cb16a0a7377c","400":"6e399ae5-b3bc-4995-bb22-814e89ce796e","401":"ecc04742-3830-490b-9968-d861abef4b39","403":"b1a9226a-565e-4d6e-9d17-07753c19e03c","404":"29f11f00-f04d-41d2-9f85-882bf33b075a","409":"f30c6c99-f334-46a1-84bd-f88ceccf5c98","429":"9f3bfbc3-c8fd-42d1-9f7c-6d5a180435c8","503":"40108bf4-bb12-4c1b-8e6d-6bc3b160494b"},"method":"patch","type":"path","servers":["5f3f6a58-0ee7-4c08-afb8-67d72ede46bb"],"security":["b99d229e-906d-4004-b947-561338ff7df8"],"path":"/drafts/{id}","baseUrlOptions":["https://postmesh.app/api/v1"],"title":"Change a draft","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"30839070-d5d0-4fe4-af0f-a841eb88f8d9":{"name":"id","in":"path","required":true,"description":"The draft's id.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The draft's id.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206,"uniqueKey":"content","typeLabel":"string"},"platforms":{"maxItems":12,"type":"array","items":{"type":"string","enum":["twitter","youtube","instagram","tiktok","threads","facebook","linkedin","reddit","bluesky","mastodon","telegram","discord"],"description":"A network PostMesh posts to.","uniqueKey":"platforms.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"platforms","typeLabel":"enum\u003cstring>[]"},"scheduled_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"scheduled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"scheduled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"scheduled_at","typeLabel":"string\u003cdate-time> | null"},"metadata":{"description":"Merged into the saved metadata key by key.","type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"metadata","typeLabel":"object"},"label_ids":{"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"label_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"label_ids","typeLabel":"string\u003cuuid>[]"},"expected_updated_at":{"type":"string","format":"date-time","uniqueKey":"expected_updated_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"Changes to a draft. Fields left out stay as they are.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"content":"\u003cstring>","platforms":[],"scheduled_at":"2023-11-07T05:31:56Z","metadata":{},"label_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"expected_updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d6cb094e-cd8d-45f8-8369-cb16a0a7377c":{"description":"The draft as it is now.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"draft.id","typeLabel":"string\u003cuuid>"},"content":{"type":"string","isRequired":true,"uniqueKey":"draft.content","typeLabel":"string"},"platforms":{"type":"array","items":{"type":"string","uniqueKey":"draft.platforms.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"draft.platforms","typeLabel":"string[]"},"scheduled_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"draft.scheduled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"draft.scheduled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"draft.scheduled_at","typeLabel":"string\u003cdate-time> | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"draft.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"draft.metadata.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"draft.metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"draft.metadata","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"draft.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"draft.updated_at","typeLabel":"string\u003cdate-time>"},"label_ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"draft.label_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"draft.label_ids","typeLabel":"string\u003cuuid>[]"}},"required":["id","content","platforms","scheduled_at","metadata","created_at","updated_at"],"additionalProperties":false,"description":"A saved draft.","isRequired":true,"uniqueKey":"draft","typeLabel":"object"}},"required":["draft"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"draft":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"\u003cstring>","platforms":["\u003cstring>"],"scheduled_at":"2023-11-07T05:31:56Z","metadata":{},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","label_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"6e399ae5-b3bc-4995-bb22-814e89ce796e":{"description":"The request was refused: a field is missing or invalid. `field` names it.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"ecc04742-3830-490b-9968-d861abef4b39":{"description":"No API key, or one that isn't valid any more.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"b1a9226a-565e-4d6e-9d17-07753c19e03c":{"description":"The key can't do this: it needs another scope (`code` is `api_key_scope`), or it is in approval mode.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"29f11f00-f04d-41d2-9f85-882bf33b075a":{"description":"No such item in your PostMesh.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"f30c6c99-f334-46a1-84bd-f88ceccf5c98":{"description":"The item changed since you read it, is being sent right now, or a request with this Idempotency-Key is still running.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"9f3bfbc3-c8fd-42d1-9f7c-6d5a180435c8":{"description":"Too many requests. Wait for `Retry-After` seconds.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"40108bf4-bb12-4c1b-8e6d-6bc3b160494b":{"description":"PostMesh can't answer right now. Try again shortly.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b99d229e-906d-4004-b947-561338ff7df8":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from Settings, API \u0026 MCP: pm_live_...","scopes":[],"schemeName":"apiKey"}}},"servers":{"5f3f6a58-0ee7-4c08-afb8-67d72ede46bb":{"url":"https://postmesh.app/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from Settings, API \u0026 MCP: pm_live_...","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from Settings, API \u0026 MCP: pm_live_...","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"post-mesh","siteName":"PostMesh","title":"Change a draft - PostMesh","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T03:32:13.953Z","originalFileLocation":"api-reference/drafts/change-a-draft.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=\"Changes the fields you send and keeps the rest. Needs an API key with the drafts scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PostMesh\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_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=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Change a draft - PostMesh\">\u003cmeta data-mint-head property=\"og:description\" content=\"Changes the fields you send and keeps the rest. Needs an API key with the drafts scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PostMesh\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://postmesh.app/docs/api-reference/drafts/change-a-draft\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://postmesh.app/brand/social-card.png\">\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=\"Change a draft - PostMesh\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Changes the fields you send and keeps the rest. Needs an API key with the drafts scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://postmesh.app/brand/social-card.png\">\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=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PostMesh\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4A6400\">\u003clink data-mint-head rel=\"canonical\" href=\"https://postmesh.app/docs/api-reference/drafts/change-a-draft\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/drafts/change-a-draft.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://postmesh.app/#organization\",\"name\":\"PostMesh\",\"url\":\"https://postmesh.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/light.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=c13168a50d17ec8f05a48af736f712b5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://postmesh.app/docs#website\",\"name\":\"PostMesh\",\"url\":\"https://postmesh.app/docs\",\"publisher\":{\"@id\":\"https://postmesh.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft#webpage\",\"url\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft\",\"name\":\"Change a draft\",\"description\":\"Changes the fields you send and keeps the rest. Needs an API key with the drafts scope.\",\"dateModified\":\"2026-11-04T03:32:13.953Z\",\"isPartOf\":{\"@id\":\"https://postmesh.app/docs#website\"},\"breadcrumb\":{\"@id\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://postmesh.app/docs/api-reference/accounts/who-you-are\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Drafts\",\"item\":\"https://postmesh.app/docs/api-reference/drafts/list-drafts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Change a draft\",\"item\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft#apireference\",\"headline\":\"Change a draft\",\"name\":\"Change a draft\",\"description\":\"Changes the fields you send and keeps the rest. Needs an API key with the drafts scope.\",\"url\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft\",\"mainEntityOfPage\":{\"@id\":\"https://postmesh.app/docs/api-reference/drafts/change-a-draft#webpage\"},\"image\":\"https://postmesh.app/brand/social-card.png\",\"dateModified\":\"2026-11-04T03:32:13.953Z\",\"publisher\":{\"@id\":\"https://postmesh.app/#organization\"},\"isPartOf\":{\"@id\":\"https://postmesh.app/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PostMesh\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PostMesh","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"PostMesh docs","sidebarTitle":"Introduction","href":"/index"},{"title":"Quickstart: your first post to every network","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Connect Instagram, TikTok, YouTube and more","sidebarTitle":"Connect your accounts","href":"/connect-accounts"},{"title":"Plans, trial and billing","sidebarTitle":"Plans and billing","href":"/plans-and-billing"}]},{"group":"Publishing","pages":[{"title":"Different captions for each social network","sidebarTitle":"Captions per network","href":"/captions-per-network"},{"title":"Schedule posts to every network","sidebarTitle":"Schedule posts","href":"/schedule-posts"},{"title":"Pre-flight checks before every post","sidebarTitle":"Pre-flight checks","href":"/pre-flight-checks"},{"title":"Drafts and bulk CSV import","sidebarTitle":"Drafts and CSV import","href":"/drafts-and-csv-import"},{"title":"Send a post to your client for approval","sidebarTitle":"Client approvals","href":"/client-approvals"},{"title":"Why a post failed and how to retry it","sidebarTitle":"Fix a failed post","href":"/fix-a-failed-post"}]},{"group":"Networks","pages":[{"title":"Supported networks and what each takes","sidebarTitle":"All networks","href":"/networks"},{"title":"Post to Discord with a channel webhook","sidebarTitle":"Discord","href":"/discord"}]},{"group":"Automate","pages":[{"title":"Post to social media from Claude, Cursor and Codex (MCP)","sidebarTitle":"Connect an AI assistant","href":"/mcp-setup"},{"title":"MCP tool reference","sidebarTitle":"MCP tool reference","href":"/mcp-tools"},{"title":"API keys","sidebarTitle":"API keys","href":"/api-keys"},{"title":"Webhooks","sidebarTitle":"Webhooks","href":"/webhooks"},{"title":"AI Agent: draft posts for every network","sidebarTitle":"AI Agent","href":"/ai-agent"},{"title":"Clip Factory: short clips from a YouTube video","sidebarTitle":"Clip Factory","href":"/clip-factory"}]},{"group":"Account","pages":[{"title":"Analytics for posts sent from PostMesh","sidebarTitle":"Analytics","href":"/analytics"},{"title":"Export your data or delete your account","sidebarTitle":"Data and privacy","href":"/data-and-privacy"}]},{"group":"API reference","pages":[{"group":"Accounts","pages":[{"title":"Who you are","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/accounts/who-you-are"},{"title":"List connected accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts","href":"/api-reference/accounts/list-connected-accounts"}]},{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"/openapi.json get /posts","href":"/api-reference/posts/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts","href":"/api-reference/posts/create-a-post"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{id}","href":"/api-reference/posts/get-a-post"},{"title":"Delete a post from PostMesh","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{id}","href":"/api-reference/posts/delete-a-post-from-postmesh"},{"title":"Change a scheduled post","deprecated":null,"version":null,"openapi":"/openapi.json patch /posts/{id}","href":"/api-reference/posts/change-a-scheduled-post"},{"title":"Cancel a scheduled post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/cancel","href":"/api-reference/posts/cancel-a-scheduled-post"},{"title":"Retry a failed post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/retry","href":"/api-reference/posts/retry-a-failed-post"}]},{"group":"Analytics","pages":[{"title":"Get a post's numbers","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{id}/analytics","href":"/api-reference/analytics/get-a-posts-numbers"},{"title":"Get analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics","href":"/api-reference/analytics/get-analytics"}]},{"group":"Drafts","pages":[{"title":"List drafts","deprecated":null,"version":null,"openapi":"/openapi.json get /drafts","href":"/api-reference/drafts/list-drafts"},{"title":"Create a draft","deprecated":null,"version":null,"openapi":"/openapi.json post /drafts","href":"/api-reference/drafts/create-a-draft"},{"title":"Get a draft","deprecated":null,"version":null,"openapi":"/openapi.json get /drafts/{id}","href":"/api-reference/drafts/get-a-draft"},{"title":"Delete a draft","description":"Removes the draft for good.\n\nNeeds an API key with the `drafts` scope.","deprecated":null,"version":null,"openapi":"/openapi.json delete /drafts/{id}","href":"/api-reference/drafts/delete-a-draft"},{"title":"Change a draft","deprecated":null,"version":null,"openapi":"/openapi.json patch /drafts/{id}","href":"/api-reference/drafts/change-a-draft"}]},{"group":"Media","pages":[{"title":"List media","description":"The files in your media library, newest first.\n\nNeeds an API key with the `read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /media","href":"/api-reference/media/list-media"},{"title":"Add a file","deprecated":null,"version":null,"openapi":"/openapi.json post /media","href":"/api-reference/media/add-a-file"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/openapi.json get /media/{id}","href":"/api-reference/media/get-a-file"},{"title":"Get an upload link","deprecated":null,"version":null,"openapi":"/openapi.json post /media/uploads","href":"/api-reference/media/get-an-upload-link"}]}]}]},"basePath":"","title":"Change a draft - PostMesh","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}