Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or “now”. It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts//proposals) before proposing it again.
Any unique string (e.g. a UUID). A retry with the same key and request returns the first answer (Idempotent-Replayed: true, ids only) instead of doing it twice. Kept 24 hours.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CaptureFlow API","description":"Connect AI assistants and your own tools to CaptureFlow: the REST API and the MCP server.","colors":{"primary":"#7C3AED","light":"#A855F7","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/capture-flow/t7wVJOfCjnkpBr6I/logo/light.png?fit=max\u0026auto=format\u0026n=t7wVJOfCjnkpBr6I\u0026q=85\u0026s=2e3560c99c02683d52b248d6687733f1","dark":"https://mintcdn.com/capture-flow/t7wVJOfCjnkpBr6I/logo/dark.png?fit=max\u0026auto=format\u0026n=t7wVJOfCjnkpBr6I\u0026q=85\u0026s=0af06966fa2259640e3d130dc6e587a8","href":"https://captureflow.ai"},"favicon":"https://mintcdn.com/capture-flow/t7wVJOfCjnkpBr6I/favicon.png?fit=max\u0026auto=format\u0026n=t7wVJOfCjnkpBr6I\u0026q=85\u0026s=78dde9dde3fa7e9ade6c677bcf6c3600","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://help.captureflow.ai","label":"Help center"}],"primary":{"type":"button","label":"Open CaptureFlow","href":"https://app.captureflow.ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"capture-flow","hasAudioNarration":false,"actualSubdomain":"capture-flow","customDomains":[],"gitSource":{"type":"github","owner":"captureflow-ai","repo":"captureflow-app","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":"","_id":"6ae60b79b2ba51455ce8d692"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae60c79b2ba51455ce8de2e","clientVersion":"0.0.4043","searchFilterCounts":[]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/posts/propose-a-post-for-approval","slug":"/api-reference/posts/propose-a-post-for-approval","pageMetadata":{"title":"Propose a post for approval","description":"Proposes the post to the given accounts at `when` (ISO 8601 with a time zone, at least 5 minutes ahead) or \"now\". It goes out only after the user accepts it in CaptureFlow at `approval_url`: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/proposals","href":"/api-reference/posts/propose-a-post-for-approval","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Proposes the post to the given accounts at \", _jsx(_components.code, {\n children: \"when\"\n }), \" (ISO 8601 with a time zone, at least 5 minutes ahead) or “now”. It goes out only after the user accepts it in CaptureFlow at \", _jsx(_components.code, {\n children: \"approval_url\"\n }), \": the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/\", \"/proposals) before proposing it again.\"]\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":"Propose a post for approval","description":"Proposes the post to the given accounts at `when` (ISO 8601 with a time zone, at least 5 minutes ahead) or \"now\". It goes out only after the user accepts it in CaptureFlow at `approval_url`: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/proposals","href":"/api-reference/posts/propose-a-post-for-approval","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"propose_post_schedule","summary":"Propose a post for approval","description":"Proposes the post to the given accounts at `when` (ISO 8601 with a time zone, at least 5 minutes ahead) or \"now\". It goes out only after the user accepts it in CaptureFlow at `approval_url`: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.","tags":["Posts"],"x-required-scope":"posts:schedule","x-requires-paid-plan":true,"parameters":["af8a50d0-d999-457a-8cda-8f7b93b9dfd8","91abdb02-b72e-4f80-a208-e9235e85281c","8cad3e55-1663-43f3-aa72-beca28e77ffc","37b14baa-2183-47b0-a692-aaa43b47c512"],"requestBody":"f6f9c609-8d14-421f-be81-42407a2d0336","responses":{"200":"036b96a2-63a6-4ead-9dad-4474cfd555c5","400":"43a0bcc2-6c6b-427f-8fdb-c02ed6017a81","401":"46039437-5874-462e-8461-5a66e8aa7370","402":"9e031581-0f0b-4a02-a1d1-2392aecb7231","403":"93e63028-3ca1-43b3-8688-faaf7594dcfc","404":"5ec5e434-8466-4a74-bc8b-52146e87f167","409":"810e9548-0994-4ea3-88c8-0f9209aa8481","413":"124fcee0-c679-4ecc-bd67-6f2caafeb3b1","422":"7da8b265-d44f-4f30-b45d-27ea9f1df66a","423":"53baceae-bc34-4dca-aaff-f6677b682c01","429":"dd13b828-1540-45ff-97d9-94ff68968c41","500":"07b08090-d640-400d-99ed-a37996b3717b","503":"50a2b946-dcd0-4f2b-90db-ad7cf2c520c5"},"method":"post","type":"path","servers":["2b5c21bd-b102-4986-8144-783d214dd3fa"],"security":["c11a2098-65b5-4b48-af79-0f6ca6d9415c","7bce2933-a274-48a5-bc75-97e402904437"],"path":"/posts/{id}/proposals","baseUrlOptions":["https://api.captureflow.ai/v1"],"title":"Propose a post for approval","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"af8a50d0-d999-457a-8cda-8f7b93b9dfd8":{"in":"query","name":"workspace_id","schema":{"description":"The workspace to act in. Optional when the key has a default or a lock, or you belong to one workspace.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The workspace to act in. Optional when the key has a default or a lock, or you belong to one workspace."},"91abdb02-b72e-4f80-a208-e9235e85281c":{"in":"query","name":"as_user","schema":{"description":"API keys of owners and admins only (not OAuth apps): act as this member of the workspace (like View As). Every use is audited.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"API keys of owners and admins only (not OAuth apps): act as this member of the workspace (like View As). Every use is audited."},"8cad3e55-1663-43f3-aa72-beca28e77ffc":{"in":"path","name":"id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The id of the idea, input, post or agent run.","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true,"description":"The id of the idea, input, post or agent run."},"37b14baa-2183-47b0-a692-aaa43b47c512":{"in":"header","name":"Idempotency-Key","schema":{"description":"Any unique string (e.g. a UUID). A retry with the same key and request returns the first answer (`Idempotent-Replayed: true`, ids only) instead of doing it twice. Kept 24 hours.","type":"string","maxLength":255,"uniqueKey":"","typeLabel":"string"},"description":"Any unique string (e.g. a UUID). A retry with the same key and request returns the first answer (`Idempotent-Replayed: true`, ids only) instead of doing it twice. Kept 24 hours."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"social_account_ids":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"social_account_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Connected accounts to post to (list_social_accounts).","isRequired":true,"uniqueKey":"social_account_ids","typeLabel":"string\u003cuuid>[]"},"when":{"type":"string","description":"\"now\", or an ISO 8601 date-time with an offset, e.g. 2026-11-03T09:00:00+01:00.","isRequired":true,"uniqueKey":"when","typeLabel":"string"}},"required":["social_account_ids","when"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"social_account_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"when":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"036b96a2-63a6-4ead-9dad-4474cfd555c5":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"proposal","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The post id.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","const":"to_accept","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"scheduled_at":{"oneOf":[{"description":"When it will go out once accepted (UTC); null with asap.","type":"string","isRequired":true,"uniqueKey":"scheduled_at.oneOf.0","typeLabel":"string"},{"description":"When it will go out once accepted (UTC); null with asap.","type":"null","isRequired":true,"uniqueKey":"scheduled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scheduled_at","typeLabel":"string | null"},"asap":{"type":"boolean","description":"Goes out as soon as it is accepted.","isRequired":true,"uniqueKey":"asap","typeLabel":"boolean"},"approval_url":{"type":"string","description":"Where the user accepts it.","isRequired":true,"uniqueKey":"approval_url","typeLabel":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"targets.items.[INDEX].social_account_id","typeLabel":"string\u003cuuid>"},"platform":{"type":"string","isRequired":true,"uniqueKey":"targets.items.[INDEX].platform","typeLabel":"string"}},"required":["social_account_id","platform"],"additionalProperties":false,"uniqueKey":"targets.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"targets","typeLabel":"object[]"}},"required":["object","id","status","scheduled_at","asap","approval_url","targets"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"proposal","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"to_accept","scheduled_at":"\u003cstring>","asap":true,"approval_url":"\u003cstring>","targets":[{"social_account_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","platform":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"43a0bcc2-6c6b-427f-8fdb-c02ed6017a81":{"description":"Invalid request (`validation_failed`, `workspace_required`, `credentials_in_url`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"46039437-5874-462e-8461-5a66e8aa7370":{"description":"Missing, invalid, revoked or expired key or access token (`unauthorized`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"9e031581-0f0b-4a02-a1d1-2392aecb7231":{"description":"This workspace needs a paid plan or a trial (`plan_required`, with `details.upgrade_url`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"93e63028-3ca1-43b3-8688-faaf7594dcfc":{"description":"Not allowed (`insufficient_scope`, `api_disabled`, `workspace_locked`, `as_user_forbidden`, `viewer_read_only`, `managed_member_restricted`, `platform_not_enabled`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"5ec5e434-8466-4a74-bc8b-52146e87f167":{"description":"Not found, or not yours (`not_found`, `workspace_not_found`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"810e9548-0994-4ea3-88c8-0f9209aa8481":{"description":"Conflict (`post_not_editable`, `post_has_variant`, `post_not_proposable`, `not_proposed`, `idempotency_conflict`, `idempotency_in_progress`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"124fcee0-c679-4ecc-bd67-6f2caafeb3b1":{"description":"Request body over 100 KB (`body_too_large`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7da8b265-d44f-4f30-b45d-27ea9f1df66a":{"description":"The content can't be used as it is (`url_unreadable`, `preflight_failed` with `details.issues`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"53baceae-bc34-4dca-aaff-f6677b682c01":{"description":"The account or workspace is scheduled for deletion (`deletion_pending`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"dd13b828-1540-45ff-97d9-94ff68968c41":{"description":"Rate limited (`rate_limited`); see `Retry-After`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"07b08090-d640-400d-99ed-a37996b3717b":{"description":"Our fault (`internal_error`); quote the `request_id`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"50a2b946-dcd0-4f2b-90db-ad7cf2c520c5":{"description":"The API is not available (`api_unavailable`), or changes are paused (`writes_unavailable`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"The kind of error, e.g. `permission_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Stable code to branch on, e.g. `insufficient_scope`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people; may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["type","code","message","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>","param":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c11a2098-65b5-4b48-af79-0f6ca6d9415c":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"cf_live_...","description":"An API key from Settings > API \u0026 MCP.","scopes":[],"schemeName":"apiKey"}},"7bce2933-a274-48a5-bc75-97e402904437":{"oauth2":{"type":"oauth2","description":"An app the user connected (OAuth 2.1, PKCE S256, client ID metadata documents or dynamic registration). Access tokens look like `cfo_at_...`.","flows":{"authorizationCode":{"authorizationUrl":"https://app.captureflow.ai/oauth/authorize","tokenUrl":"https://app.captureflow.ai/api/oauth/token","refreshUrl":"https://app.captureflow.ai/api/oauth/token","scopes":{"ideas:read":"Read content ideas.","ideas:write":"Create content ideas.","inputs:read":"Read inputs (text, links, uploads) and their processing state.","inputs:write":"Create inputs: text, links and file uploads.","posts:read":"Read posts and check them against platform rules.","posts:write":"Create and edit draft posts.","posts:schedule":"Propose posts for scheduling or posting; the user accepts each proposal in CaptureFlow.","strategy:read":"Read the content strategy.","brand:read":"Reserved: no endpoints yet.","knowledge:read":"Reserved: no endpoints yet.","accounts:read":"Read connected social accounts.","analytics:read":"Reserved: no endpoints yet.","agent:run":"Start the content agent and read its runs."}}},"scopes":[],"schemeName":"oauth2"}}},"servers":{"2b5c21bd-b102-4986-8144-783d214dd3fa":{"url":"https://api.captureflow.ai/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"cf_live_...","description":"An API key from Settings > API \u0026 MCP.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from Settings > API \u0026 MCP.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"oauth2","description":"An app the user connected (OAuth 2.1, PKCE S256, client ID metadata documents or dynamic registration). Access tokens look like `cfo_at_...`.","flows":{"authorizationCode":{"authorizationUrl":"https://app.captureflow.ai/oauth/authorize","tokenUrl":"https://app.captureflow.ai/api/oauth/token","refreshUrl":"https://app.captureflow.ai/api/oauth/token","scopes":{"ideas:read":"Read content ideas.","ideas:write":"Create content ideas.","inputs:read":"Read inputs (text, links, uploads) and their processing state.","inputs:write":"Create inputs: text, links and file uploads.","posts:read":"Read posts and check them against platform rules.","posts:write":"Create and edit draft posts.","posts:schedule":"Propose posts for scheduling or posting; the user accepts each proposal in CaptureFlow.","strategy:read":"Read the content strategy.","brand:read":"Reserved: no endpoints yet.","knowledge:read":"Reserved: no endpoints yet.","accounts:read":"Read connected social accounts.","analytics:read":"Reserved: no endpoints yet.","agent:run":"Start the content agent and read its runs."}}},"scopes":[],"schemeName":"oauth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"An app the user connected (OAuth 2.1, PKCE S256, client ID metadata documents or dynamic registration). Access tokens look like `cfo_at_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"openapi.json"},"subdomain":"capture-flow","siteName":"CaptureFlow API","title":"Propose a post for approval - CaptureFlow API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T15:43:04.168Z","originalFileLocation":"api-reference/posts/propose-a-post-for-approval.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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=\"Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or \u0026quot;now\u0026quot;. It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CaptureFlow API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_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/capture-flow/u9YDzEJS5mYXcasd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Propose a post for approval - CaptureFlow API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or \u0026quot;now\u0026quot;. It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CaptureFlow API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://capture-flow.mintlify.app/_mintlify/api/og/v2?division=Posts\u0026amp;title=Propose+a+post+for+approval\u0026amp;description=Proposes+the+post+to+the+given+accounts+at+%60when%60+%28ISO+8601+with+a+time+zone%2C+at+least+5+minutes+ahead%29+or+%22now%22.+It+goes+out+only+after+the+user+accepts+it+in+\u0026amp;theme=43c1e48b5b7e7c553db8c0dd\u0026amp;signature=e31dbf2024b78e6a1c72a8cb8af13a0f93b87e73411ef9130a2a5087edfb3229\">\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=\"Propose a post for approval - CaptureFlow API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or \u0026quot;now\u0026quot;. It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://capture-flow.mintlify.app/_mintlify/api/og/v2?division=Posts\u0026amp;title=Propose+a+post+for+approval\u0026amp;description=Proposes+the+post+to+the+given+accounts+at+%60when%60+%28ISO+8601+with+a+time+zone%2C+at+least+5+minutes+ahead%29+or+%22now%22.+It+goes+out+only+after+the+user+accepts+it+in+\u0026amp;theme=43c1e48b5b7e7c553db8c0dd\u0026amp;signature=e31dbf2024b78e6a1c72a8cb8af13a0f93b87e73411ef9130a2a5087edfb3229\">\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/capture-flow/u9YDzEJS5mYXcasd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CaptureFlow API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/posts/propose-a-post-for-approval.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://capture-flow.mintlify.app/#organization\",\"name\":\"CaptureFlow API\",\"url\":\"https://capture-flow.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/capture-flow/t7wVJOfCjnkpBr6I/logo/light.png?fit=max\u0026auto=format\u0026n=t7wVJOfCjnkpBr6I\u0026q=85\u0026s=2e3560c99c02683d52b248d6687733f1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://capture-flow.mintlify.app#website\",\"name\":\"CaptureFlow API\",\"url\":\"https://capture-flow.mintlify.app\",\"publisher\":{\"@id\":\"https://capture-flow.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval#webpage\",\"url\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval\",\"name\":\"Propose a post for approval\",\"description\":\"Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or \\\"now\\\". It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.\",\"dateModified\":\"2026-10-31T15:43:04.168Z\",\"isPartOf\":{\"@id\":\"https://capture-flow.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Posts\",\"item\":\"https://capture-flow.mintlify.app/api-reference/posts/list-posts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Propose a post for approval\",\"item\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval#apireference\",\"headline\":\"Propose a post for approval\",\"name\":\"Propose a post for approval\",\"description\":\"Proposes the post to the given accounts at when (ISO 8601 with a time zone, at least 5 minutes ahead) or \\\"now\\\". It goes out only after the user accepts it in CaptureFlow at approval_url: the API never publishes on its own. A post already waiting for acceptance must be withdrawn (DELETE /posts/{id}/proposals) before proposing it again.\",\"url\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval\",\"mainEntityOfPage\":{\"@id\":\"https://capture-flow.mintlify.app/api-reference/posts/propose-a-post-for-approval#webpage\"},\"dateModified\":\"2026-10-31T15:43:04.168Z\",\"publisher\":{\"@id\":\"https://capture-flow.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://capture-flow.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CaptureFlow API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CaptureFlow API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"API reference","groups":[{"group":"Meta","pages":[{"title":"Is the API up","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/meta/is-the-api-up"}]},{"group":"Account","pages":[{"title":"Who this key or app acts for","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/account/who-this-key-or-app-acts-for"},{"title":"Workspaces this key can act in","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces","href":"/api-reference/account/workspaces-this-key-can-act-in"}]},{"group":"Ideas","pages":[{"title":"List ideas","deprecated":null,"version":null,"openapi":"/openapi.json get /ideas","href":"/api-reference/ideas/list-ideas"},{"title":"Create an idea","deprecated":null,"version":null,"openapi":"/openapi.json post /ideas","href":"/api-reference/ideas/create-an-idea"},{"title":"Get an idea","deprecated":null,"version":null,"openapi":"/openapi.json get /ideas/{id}","href":"/api-reference/ideas/get-an-idea"}]},{"group":"Inputs","pages":[{"title":"List inputs","deprecated":null,"version":null,"openapi":"/openapi.json get /inputs","href":"/api-reference/inputs/list-inputs"},{"title":"Get an input","deprecated":null,"version":null,"openapi":"/openapi.json get /inputs/{id}","href":"/api-reference/inputs/get-an-input"},{"title":"Add text as an input","deprecated":null,"version":null,"openapi":"/openapi.json post /inputs/text","href":"/api-reference/inputs/add-text-as-an-input"},{"title":"Add a web page as an input","deprecated":null,"version":null,"openapi":"/openapi.json post /inputs/url","href":"/api-reference/inputs/add-a-web-page-as-an-input"},{"title":"Start a file upload","deprecated":null,"version":null,"openapi":"/openapi.json post /inputs/uploads","href":"/api-reference/inputs/start-a-file-upload"},{"title":"Get a file upload","deprecated":null,"version":null,"openapi":"/openapi.json get /inputs/uploads/{id}","href":"/api-reference/inputs/get-a-file-upload"},{"title":"Get a new upload URL","deprecated":null,"version":null,"openapi":"/openapi.json post /inputs/uploads/{id}/url","href":"/api-reference/inputs/get-a-new-upload-url"},{"title":"Complete a file upload","deprecated":null,"version":null,"openapi":"/openapi.json post /inputs/uploads/{id}/complete","href":"/api-reference/inputs/complete-a-file-upload"}]},{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"/openapi.json get /posts","href":"/api-reference/posts/list-posts"},{"title":"Create a draft post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts","href":"/api-reference/posts/create-a-draft-post"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{id}","href":"/api-reference/posts/get-a-post"},{"title":"Edit a draft post","deprecated":null,"version":null,"openapi":"/openapi.json patch /posts/{id}","href":"/api-reference/posts/edit-a-draft-post"},{"title":"Check a post before proposing it","description":"Whether each account could take this post as it is (connected, enabled, text within the platform's rules). Changes nothing. Media is checked again when the post is accepted.","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/preflight","href":"/api-reference/posts/check-a-post-before-proposing-it"},{"title":"Propose a post for approval","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/proposals","href":"/api-reference/posts/propose-a-post-for-approval"},{"title":"Withdraw a proposal","description":"The post goes back to a draft and its proposed targets are cancelled. Only while it waits for approval.","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{id}/proposals","href":"/api-reference/posts/withdraw-a-proposal"}]},{"group":"Social accounts","pages":[{"title":"List connected social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts","href":"/api-reference/social-accounts/list-connected-social-accounts"}]},{"group":"Strategy","pages":[{"title":"Get the content strategy","deprecated":null,"version":null,"openapi":"/openapi.json get /strategy","href":"/api-reference/strategy/get-the-content-strategy"}]},{"group":"Content agent","pages":[{"title":"Start the content agent","deprecated":null,"version":null,"openapi":"/openapi.json post /agent/runs","href":"/api-reference/content-agent/start-the-content-agent"},{"title":"Get a content agent run","deprecated":null,"version":null,"openapi":"/openapi.json get /agent/runs/{id}","href":"/api-reference/content-agent/get-a-content-agent-run"}]}]}]},"basePath":"","title":"Propose a post for approval - CaptureFlow API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}