A key you generate per post, written down BEFORE the call. Replaying a completed key returns the earlier result instead of publishing again — from outside that looks exactly like being ignored. Reusing one for a DIFFERENT body answers idempotency_conflict.
The post BODY. This is NOT the post title: title (and the per-channel <channel>_title) is a separate field, and putting the body in it skips the caption-length check.
processing and scheduled are not outcomes yet — poll GET /v1/posts/status. draft: no channel refused, but at least one holds the post as a draft (see results.<channel>.draft); it is final. canceled comes from a status poll only: a scheduled post that was cancelled before it ran. unknown: the publish call stopped waiting before the channels answered (502 upstream_timeout) and their side has not picked the post up yet; keep polling.
Present only when the shared caption was cut to fit a channel. One entry per channel and text: text is title, caption or description, field the channel field the cut text went in, length the caption's length and limit the cap, both in unit (utf16 characters, or utf8 bytes for YouTube's description). Every channel not listed received the full caption.
Present only when a channel published the post but not exactly as asked — for example a TikTok photo that went out without the requested music. status is not changed by a warning: the post is live, so do not retry it. On an async post warnings appear on GET /v1/posts/status, not on the first publish response. A warning a platform returns only with the first answer of a post is on the publish response only.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MADIAD Hub","colors":{"primary":"#E94560","light":"#F06A85","dark":"#C6304A"},"logo":{"light":"https://mintcdn.com/madiad/Mj3-H695_0iRBnvi/logo/light.png?fit=max\u0026auto=format\u0026n=Mj3-H695_0iRBnvi\u0026q=85\u0026s=f5838449a831bc742256f67b7b66c167","dark":"https://mintcdn.com/madiad/Mj3-H695_0iRBnvi/logo/dark.png?fit=max\u0026auto=format\u0026n=Mj3-H695_0iRBnvi\u0026q=85\u0026s=6f5d67c559eda8d56483de4cba40ef72"},"favicon":"https://mintcdn.com/madiad/Mj3-H695_0iRBnvi/favicon.png?fit=max\u0026auto=format\u0026n=Mj3-H695_0iRBnvi\u0026q=85\u0026s=d099a09ebf3d55c21cf53c38ee8e56df","navbar":{"links":[{"href":"mailto:info@madiad.com","label":"Support"}],"primary":{"type":"button","label":"Get API Key","href":"https://hub.madiad.com/dashboard/keys"}},"footer":{"socials":{"website":"https://madiad.com","facebook":"https://facebook.com/madiadteam","linkedin":"https://linkedin.com/company/madiadteam","youtube":"https://youtube.com/@madiadteam","x":"https://x.com/madiadteam"},"links":[{"header":"MADIAD Hub","items":[{"label":"Dashboard","href":"https://hub.madiad.com/dashboard"},{"label":"Service status","href":"https://hub.madiad.com/status"},{"label":"Support","href":"mailto:info@madiad.com"}]},{"header":"Legal","items":[{"label":"Legal Center","href":"https://madiad.com/en/legal"},{"label":"Terms of Service","href":"https://madiad.com/en/terms"},{"label":"Privacy Policy","href":"https://madiad.com/en/privacy"},{"label":"Payment Policy","href":"https://madiad.com/en/legal/payment-policy"}]},{"header":"Company","items":[{"label":"About MADIAD","href":"https://madiad.com/en/about"},{"label":"CÔNG TY TNHH MTV THƯƠNG MẠI DỊCH VỤ MADIAD · Tax code 1801662825","href":"https://madiad.com/en/legal"}]}]},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"MADIAD","icon":"house","href":"https://madiad.com"},{"anchor":"Dashboard","icon":"gauge","href":"https://hub.madiad.com"},{"anchor":"Support","icon":"envelope","href":"mailto:info@madiad.com"}]},"languages":[{"language":"vi","default":true,"href":"vi"},{"language":"en","href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"madiad","hasAudioNarration":false,"actualSubdomain":"madiad","customDomains":["docs.madiad.com"],"gitSource":{"type":"github","owner":"madiadteam","repo":"madiad-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae0b9aa93d54c7ebe397426"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aef257ec11f5002730050c9","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"en","tag":"API Reference","count":77},{"language":"vi","tag":"Tham chiếu API","count":77},{"language":"en","tag":"connections","count":26},{"language":"vi","tag":"connections","count":26},{"language":"en","tag":"Concepts","count":18},{"language":"vi","tag":"Khái niệm","count":18},{"language":"en","tag":"engagement","count":9},{"language":"vi","tag":"engagement","count":9},{"language":"en","tag":"autodm","count":8},{"language":"en","tag":"posts","count":8},{"language":"vi","tag":"autodm","count":8},{"language":"vi","tag":"posts","count":8},{"language":"en","tag":"analytics","count":7},{"language":"vi","tag":"analytics","count":7},{"language":"en","tag":"queue","count":4},{"language":"vi","tag":"queue","count":4},{"language":"en","tag":"Get Started","count":3},{"language":"en","tag":"ffmpeg","count":3},{"language":"vi","tag":"Bắt đầu","count":3},{"language":"vi","tag":"ffmpeg","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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/posts/publish-a-document-post","slug":"/api-reference/posts/publish-a-document-post","pageMetadata":{"title":"Publish a document post","description":"Publish a PDF, PPT, PPTX, DOC or DOCX. `caption` becomes the document title on the post.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/document","href":"/api-reference/posts/publish-a-document-post","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: [\"Publish a PDF, PPT, PPTX, DOC or DOCX. \", _jsx(_components.code, {\n children: \"caption\"\n }), \" becomes the document title on the post.\"]\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":"Publish a document post","description":"Publish a PDF, PPT, PPTX, DOC or DOCX. `caption` becomes the document title on the post.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/document","href":"/api-reference/posts/publish-a-document-post","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["posts"],"summary":"Publish a document post","operationId":"publishDocument","description":"Publish a PDF, PPT, PPTX, DOC or DOCX. `caption` becomes the document title on the post.","parameters":["c708a6de-8c13-41f5-8a7c-a9dbe5c45968"],"requestBody":"0e756907-069d-44c6-b7eb-54d41a225612","responses":{"200":"573304bc-4016-4f28-9d81-fe261c0b4fd2","400":"6790d0d7-800b-43d6-b3da-630fd3dff899","401":"7579610e-2235-4274-ac6e-086d87cf32dd","403":"f41a5143-fc93-47e7-918a-7481156e1ca6","404":"1bd77743-ccfc-41ae-a187-806cc25ed3f9","429":"05771830-a953-4726-838f-a8bfb3ec4d75","500":"2d3f1b79-bf7b-480b-b3b5-9d33b2b4ab6d","502":"eb10c72c-e9f7-48bb-a394-bf581edfbf2f"},"method":"post","type":"path","servers":["4ededb21-4389-4077-b497-b52f394b342b"],"security":["97046f1a-9d03-48fa-8c85-75042b1f00fb"],"path":"/v1/posts/document","baseUrlOptions":["https://api.madiad.com"],"title":"Publish a document post","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c708a6de-8c13-41f5-8a7c-a9dbe5c45968":{"name":"Idempotency-Key","in":"header","required":false,"description":"A key you generate per post, written down BEFORE the call. Replaying a completed key returns the earlier result instead of publishing again — from outside that looks exactly like being ignored. Reusing one for a DIFFERENT body answers `idempotency_conflict`.","schema":{"type":"string","isRequired":false,"description":"A key you generate per post, written down BEFORE the call. Replaying a completed key returns the earlier result instead of publishing again — from outside that looks exactly like being ignored. Reusing one for a DIFFERENT body answers `idempotency_conflict`.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_id":{"type":"string","description":"Id of the brand profile to act on. List them with `GET /v1/profiles`.","isRequired":true,"uniqueKey":"profile_id","typeLabel":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["tiktok","instagram","linkedin","youtube","facebook","x","threads","pinterest","reddit","bluesky","google_business","telegram","discord","slack","mastodon","nostr","lemmy","devto","hashnode","wordpress","whop","listmonk"],"uniqueKey":"platforms.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Channels to publish to. A comma-separated string is accepted as well.","isRequired":true,"uniqueKey":"platforms","typeLabel":"enum\u003cstring>[]"},"document_url":{"type":"string","format":"uri","description":"https:// URL of the document to publish.","isRequired":true,"uniqueKey":"document_url","typeLabel":"string\u003curi>"},"caption":{"type":"string","description":"The post BODY. This is NOT the post title: `title` (and the per-channel `\u003cchannel>_title`) is a separate field, and putting the body in it skips the caption-length check.","isRequired":true,"uniqueKey":"caption","typeLabel":"string"},"scheduled_at":{"type":"string","format":"date-time","description":"Publish at this time instead of now (ISO 8601). Pair with `timezone`.","uniqueKey":"scheduled_at","typeLabel":"string\u003cdate-time>"},"timezone":{"type":"string","description":"IANA timezone for `scheduled_at`, e.g. `Asia/Ho_Chi_Minh`.","uniqueKey":"timezone","typeLabel":"string"}},"required":["profile_id","platforms","document_url","caption"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"profile_id":"\u003cstring>","platforms":[],"document_url":"\u003cstring>","caption":"\u003cstring>","scheduled_at":"2023-11-07T05:31:56Z","timezone":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"573304bc-4016-4f28-9d81-fe261c0b4fd2":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["completed","draft","partial","failed","processing","scheduled","canceled","unknown"],"description":"`processing` and `scheduled` are not outcomes yet — poll `GET /v1/posts/status`. `draft`: no channel refused, but at least one holds the post as a draft (see `results.\u003cchannel>.draft`); it is final. `canceled` comes from a status poll only: a scheduled post that was cancelled before it ran. `unknown`: the publish call stopped waiting before the channels answered (`502 upstream_timeout`) and their side has not picked the post up yet; keep polling.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"profile_id":{"type":"string","uniqueKey":"profile_id","typeLabel":"string"},"platforms":{"type":"array","items":{"type":"string","uniqueKey":"platforms.items.[INDEX]","typeLabel":"string"},"uniqueKey":"platforms","typeLabel":"string[]"},"failed_platforms":{"type":"array","items":{"type":"string","uniqueKey":"failed_platforms.items.[INDEX]","typeLabel":"string"},"description":"Present only when at least one channel refused.","uniqueKey":"failed_platforms","typeLabel":"string[]"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"},"job_id":{"oneOf":[{"type":"string","uniqueKey":"job_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"job_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"job_id","typeLabel":"string | null"},"truncated":{"type":"array","description":"Present only when the shared `caption` was cut to fit a channel. One entry per channel and text: `text` is `title`, `caption` or `description`, `field` the channel field the cut text went in, `length` the caption's length and `limit` the cap, both in `unit` (`utf16` characters, or `utf8` bytes for YouTube's description). Every channel not listed received the full caption.","items":{"type":"object","properties":{"platform":{"type":"string","uniqueKey":"truncated.items.[INDEX].platform","typeLabel":"string"},"text":{"type":"string","enum":["title","caption","description"],"uniqueKey":"truncated.items.[INDEX].text","typeLabel":"enum\u003cstring>"},"field":{"type":"string","uniqueKey":"truncated.items.[INDEX].field","typeLabel":"string"},"length":{"type":"integer","uniqueKey":"truncated.items.[INDEX].length","typeLabel":"integer"},"limit":{"type":"integer","uniqueKey":"truncated.items.[INDEX].limit","typeLabel":"integer"},"unit":{"type":"string","enum":["utf16","utf8"],"uniqueKey":"truncated.items.[INDEX].unit","typeLabel":"enum\u003cstring>"}},"uniqueKey":"truncated.items.[INDEX]","typeLabel":"object"},"uniqueKey":"truncated","typeLabel":"object[]"},"results":{"oneOf":[{"type":"object","additionalProperties":{"type":"object","description":"One channel's verdict. `success: false` here is a CHANNEL refusal, not a Hub refusal. `draft: true` means the channel took the post into the account's drafts instead of publishing it (most often TikTok, when its daily limit on direct posts is reached): `success` stays `true`, there is no `url`, and the post is not live until the account owner publishes it in the app. Do not retry it.","properties":{"success":{"type":"boolean","uniqueKey":"results.oneOf.0.additionalProperties.success","typeLabel":"boolean"},"draft":{"type":"boolean","uniqueKey":"results.oneOf.0.additionalProperties.draft","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"results.oneOf.0.additionalProperties.error","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"results.oneOf.0.additionalProperties","typeLabel":"object"},"description":"Keyed by channel.","uniqueKey":"results.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"object","description":"One channel's verdict. `success: false` here is a CHANNEL refusal, not a Hub refusal. `draft: true` means the channel took the post into the account's drafts instead of publishing it (most often TikTok, when its daily limit on direct posts is reached): `success` stays `true`, there is no `url`, and the post is not live until the account owner publishes it in the app. Do not retry it.","properties":{"success":{"type":"boolean","uniqueKey":"results.oneOf.1.additionalProperties.success","typeLabel":"boolean"},"draft":{"type":"boolean","uniqueKey":"results.oneOf.1.additionalProperties.draft","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"results.oneOf.1.additionalProperties.error","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"results.oneOf.1.additionalProperties","typeLabel":"object"},"description":"Keyed by channel.","uniqueKey":"results.oneOf.1","typeLabel":"null"}],"uniqueKey":"results","typeLabel":"object | null"},"warnings":{"type":"array","items":{"type":"object","required":["platform","code","message"],"properties":{"platform":{"oneOf":[{"type":"string","description":"The channel the warning is about; `null` when a multi-channel call returned it without naming one.","isRequired":true,"uniqueKey":"warnings.items.[INDEX].platform.oneOf.0","typeLabel":"string"},{"type":"null","description":"The channel the warning is about; `null` when a multi-channel call returned it without naming one.","isRequired":true,"uniqueKey":"warnings.items.[INDEX].platform.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"warnings.items.[INDEX].platform","typeLabel":"string | null"},"code":{"type":"string","enum":["music_not_applied","first_comment_skipped","platform_warning"],"description":"`music_not_applied` (TikTok only) — the post went out, or was saved as a draft, without `tiktok_music_id`; reconnect TikTok on that profile. `first_comment_skipped` — `first_comment` was not posted, for example because the post was saved as a draft. `platform_warning` — any other note; read `message`. New codes may be added: treat an unknown code as `platform_warning`.","isRequired":true,"uniqueKey":"warnings.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"description":"Present only when a channel published the post but not exactly as asked — for example a TikTok photo that went out without the requested music. `status` is not changed by a warning: the post is live, so do not retry it. On an async post warnings appear on `GET /v1/posts/status`, not on the first publish response. A warning a platform returns only with the first answer of a post is on the publish response only.","uniqueKey":"warnings","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"completed","profile_id":"\u003cstring>","platforms":["\u003cstring>"],"failed_platforms":["\u003cstring>"],"request_id":"\u003cstring>","job_id":"\u003cstring>","truncated":[{"platform":"\u003cstring>","text":"title","field":"\u003cstring>","length":123,"limit":123,"unit":"utf16"}],"results":{},"warnings":[{"platform":"\u003cstring>","code":"music_not_applied","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"6790d0d7-800b-43d6-b3da-630fd3dff899":{"description":"The request was refused before anything was spent.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7579610e-2235-4274-ac6e-086d87cf32dd":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f41a5143-fc93-47e7-918a-7481156e1ca6":{"description":"The plan does not include this.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1bd77743-ccfc-41ae-a187-806cc25ed3f9":{"description":"No such resource for this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"05771830-a953-4726-838f-a8bfb3ec4d75":{"description":"Rate limit or plan quota reached.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2d3f1b79-bf7b-480b-b3b5-9d33b2b4ab6d":{"description":"Unexpected error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"eb10c72c-e9f7-48bb-a394-bf581edfbf2f":{"description":"Publishing failed, or timed out with the outcome unknown.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Every code the API can answer with. See the error table in the introduction for what each one means.","enum":["unauthorized","forbidden","not_found","invalid_request","quota_exceeded","no_active_plan","profile_limit_reached","rate_limited","idempotency_conflict","idempotency_in_progress","page_pin_conflict","page_pin_unverified","platform_not_startable","platform_unavailable","link_not_found","platform_not_connected","location_required","upstream_error","upstream_timeout","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"97046f1a-9d03-48fa-8c85-75042b1f00fb":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key, sent as `Authorization: Bearer \u003ckey>`. One key manages every profile on the account.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"4ededb21-4389-4077-b497-b52f394b342b":{"url":"https://api.madiad.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key, sent as `Authorization: Bearer \u003ckey>`. One key manages every profile on the account.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key, sent as `Authorization: Bearer \u003ckey>`. One key manages every profile on the account.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"madiad","siteName":"MADIAD Hub","title":"Publish a document post - MADIAD Hub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"vi":{"href":"/vi","matchLevel":3},"en":{"href":"/api-reference/posts/publish-a-document-post","matchLevel":0}}},"lastModified":"2026-11-07T13:20:05.383Z","originalFileLocation":"api-reference/posts/publish-a-document-post.mdx","locale":"en"},"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=\"Publish a PDF, PPT, PPTX, DOC or DOCX. caption becomes the document title on the post.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MADIAD Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_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/madiad/XsfS5lTX6EGlv7Sx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publish a document post - MADIAD Hub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Publish a PDF, PPT, PPTX, DOC or DOCX. caption becomes the document title on the post.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MADIAD Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.madiad.com/api-reference/posts/publish-a-document-post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://madiad.mintlify.site/_mintlify/api/og/v2?division=posts\u0026amp;title=Publish+a+document+post\u0026amp;description=Publish+a+PDF%2C+PPT%2C+PPTX%2C+DOC+or+DOCX.+%60caption%60+becomes+the+document+title+on+the+post.\u0026amp;theme=57345737b55bf25662c45cae\u0026amp;signature=360081b1e291803581149f55c440fc2db60b5d4cbe9199627e953f5db2bae8ce\">\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=\"Publish a document post - MADIAD Hub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Publish a PDF, PPT, PPTX, DOC or DOCX. caption becomes the document title on the post.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://madiad.mintlify.site/_mintlify/api/og/v2?division=posts\u0026amp;title=Publish+a+document+post\u0026amp;description=Publish+a+PDF%2C+PPT%2C+PPTX%2C+DOC+or+DOCX.+%60caption%60+becomes+the+document+title+on+the+post.\u0026amp;theme=57345737b55bf25662c45cae\u0026amp;signature=360081b1e291803581149f55c440fc2db60b5d4cbe9199627e953f5db2bae8ce\">\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/madiad/XsfS5lTX6EGlv7Sx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MADIAD Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E94560\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.madiad.com/api-reference/posts/publish-a-document-post\">\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/publish-a-document-post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.madiad.com/#organization\",\"name\":\"MADIAD Hub\",\"url\":\"https://docs.madiad.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/madiad/Mj3-H695_0iRBnvi/logo/light.png?fit=max\u0026auto=format\u0026n=Mj3-H695_0iRBnvi\u0026q=85\u0026s=f5838449a831bc742256f67b7b66c167\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.madiad.com#website\",\"name\":\"MADIAD Hub\",\"url\":\"https://docs.madiad.com\",\"publisher\":{\"@id\":\"https://docs.madiad.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post#webpage\",\"url\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post\",\"name\":\"Publish a document post\",\"description\":\"Publish a PDF, PPT, PPTX, DOC or DOCX. caption becomes the document title on the post.\",\"dateModified\":\"2026-11-07T13:20:05.383Z\",\"isPartOf\":{\"@id\":\"https://docs.madiad.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.madiad.com/api-reference/analytics/audience-breakdown\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Publish a document post\",\"item\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post#apireference\",\"headline\":\"Publish a document post\",\"name\":\"Publish a document post\",\"description\":\"Publish a PDF, PPT, PPTX, DOC or DOCX. caption becomes the document title on the post.\",\"url\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.madiad.com/api-reference/posts/publish-a-document-post#webpage\"},\"dateModified\":\"2026-11-07T13:20:05.383Z\",\"publisher\":{\"@id\":\"https://docs.madiad.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.madiad.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MADIAD Hub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"MADIAD Hub","nav":{"global":{"anchors":[{"anchor":"MADIAD","icon":"house","href":"https://madiad.com"},{"anchor":"Dashboard","icon":"gauge","href":"https://hub.madiad.com"},{"anchor":"Support","icon":"envelope","href":"mailto:info@madiad.com"}]},"languages":[{"language":"vi","default":true,"pages":[{"title":"vi","href":"/vi"}]},{"language":"en","groups":[{"group":"Get Started","pages":[{"title":"Overview","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"}]},{"group":"Concepts","pages":[{"title":"Profiles","href":"/concepts/profiles"},{"title":"Channels","href":"/concepts/channels"},{"title":"Posts","href":"/concepts/posts"},{"title":"Platform options","href":"/concepts/platform-options"},{"title":"Scheduling","href":"/concepts/scheduling"},{"title":"Analytics \u0026 history","href":"/concepts/analytics"},{"title":"Usage","href":"/concepts/usage"},{"title":"Boost","tag":"Beta","href":"/concepts/boost"},{"title":"Engagement","href":"/concepts/engagement"},{"title":"Google reviews","href":"/concepts/reviews"},{"title":"Idempotency","href":"/concepts/idempotency"},{"title":"Errors","href":"/concepts/errors"},{"title":"Why a post did not go out","href":"/concepts/publish-failures"},{"title":"Service status","href":"/concepts/service-status"},{"title":"Rate limits","href":"/concepts/rate-limits"},{"title":"Webhooks","href":"/concepts/webhooks"},{"title":"FFmpeg","href":"/concepts/ffmpeg"},{"title":"Platform compliance","href":"/concepts/compliance"}]},{"group":"Integrations","pages":[{"title":"n8n","href":"/integrations/n8n"},{"title":"Make","href":"/integrations/make"}]},{"group":"API Reference","pages":[{"group":"analytics","pages":[{"title":"Audience breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/audience","href":"/api-reference/analytics/audience-breakdown"},{"title":"Impressions over time","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/impressions","href":"/api-reference/analytics/impressions-over-time"},{"title":"Metrics for one post we published","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/post","href":"/api-reference/analytics/metrics-for-one-post-we-published"},{"title":"Organic metrics for a post by its channel id","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/post-organic","href":"/api-reference/analytics/organic-metrics-for-a-post-by-its-channel-id"},{"title":"Metrics for recent posts","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/posts","href":"/api-reference/analytics/metrics-for-recent-posts"},{"title":"Profile-level metrics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/profile","href":"/api-reference/analytics/profile-level-metrics"},{"title":"Content suggestions from a seed keyword","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/analytics/suggestions","href":"/api-reference/analytics/content-suggestions-from-a-seed-keyword"}]},{"group":"autodm","pages":[{"title":"List comment monitors","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/autodm/monitors","href":"/api-reference/autodm/list-comment-monitors"},{"title":"Create a comment monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/autodm/monitors","href":"/api-reference/autodm/create-a-comment-monitor"},{"title":"Read one monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/autodm/monitors/{id}","href":"/api-reference/autodm/read-one-monitor"},{"title":"Delete a monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/autodm/monitors/{id}","href":"/api-reference/autodm/delete-a-monitor"},{"title":"Read a monitor's activity","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/autodm/monitors/{id}/logs","href":"/api-reference/autodm/read-a-monitors-activity"},{"title":"Pause a monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/autodm/monitors/{id}/pause","href":"/api-reference/autodm/pause-a-monitor"},{"title":"Resume a monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/autodm/monitors/{id}/resume","href":"/api-reference/autodm/resume-a-monitor"},{"title":"Stop a monitor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/autodm/monitors/{id}/stop","href":"/api-reference/autodm/stop-a-monitor"}]},{"group":"connections","pages":[{"title":"Link devto with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/devto","href":"/api-reference/connections/link-devto-with-its-own-credentials"},{"title":"Link discord with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/discord","href":"/api-reference/connections/link-discord-with-its-own-credentials"},{"title":"Read the pinned Facebook Page","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/facebook/page","href":"/api-reference/connections/read-the-pinned-facebook-page"},{"title":"Pin a Facebook Page","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/facebook/page","href":"/api-reference/connections/pin-a-facebook-page"},{"title":"Clear the pinned Facebook Page","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/connections/facebook/page","href":"/api-reference/connections/clear-the-pinned-facebook-page"},{"title":"List Facebook Pages","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/facebook/pages","href":"/api-reference/connections/list-facebook-pages"},{"title":"Read the pinned Google Business location","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/google_business/page","href":"/api-reference/connections/read-the-pinned-google-business-location"},{"title":"Pin a Google Business location","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/google_business/page","href":"/api-reference/connections/pin-a-google-business-location"},{"title":"Clear the pinned Google Business location","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/connections/google_business/page","href":"/api-reference/connections/clear-the-pinned-google-business-location"},{"title":"Link hashnode with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/hashnode","href":"/api-reference/connections/link-hashnode-with-its-own-credentials"},{"title":"Link lemmy with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/lemmy","href":"/api-reference/connections/link-lemmy-with-its-own-credentials"},{"title":"Read the pinned LinkedIn organisation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/linkedin/page","href":"/api-reference/connections/read-the-pinned-linkedin-organisation"},{"title":"Pin a LinkedIn organisation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/linkedin/page","href":"/api-reference/connections/pin-a-linkedin-organisation"},{"title":"Clear the pinned LinkedIn organisation","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/connections/linkedin/page","href":"/api-reference/connections/clear-the-pinned-linkedin-organisation"},{"title":"List LinkedIn organisations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/linkedin/pages","href":"/api-reference/connections/list-linkedin-organisations"},{"title":"Link listmonk with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/listmonk","href":"/api-reference/connections/link-listmonk-with-its-own-credentials"},{"title":"Link mastodon with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/mastodon","href":"/api-reference/connections/link-mastodon-with-its-own-credentials"},{"title":"Link nostr with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/nostr","href":"/api-reference/connections/link-nostr-with-its-own-credentials"},{"title":"List Pinterest boards","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/pinterest/boards","href":"/api-reference/connections/list-pinterest-boards"},{"title":"Link slack with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/slack","href":"/api-reference/connections/link-slack-with-its-own-credentials"},{"title":"Open a hosted connect page","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/start","href":"/api-reference/connections/open-a-hosted-connect-page"},{"title":"Start one channel's OAuth","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/start-platform","href":"/api-reference/connections/start-one-channels-oauth"},{"title":"Read which channels each profile has linked","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/connections/status","href":"/api-reference/connections/read-which-channels-each-profile-has-linked"},{"title":"Link telegram with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/telegram","href":"/api-reference/connections/link-telegram-with-its-own-credentials"},{"title":"Link whop with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/whop","href":"/api-reference/connections/link-whop-with-its-own-credentials"},{"title":"Link wordpress with its own credentials","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/wordpress","href":"/api-reference/connections/link-wordpress-with-its-own-credentials"}]},{"group":"engagement","pages":[{"title":"Read comments on a post","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/engagement/comments","href":"/api-reference/engagement/read-comments-on-a-post"},{"title":"Moderate a comment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/comments/action","href":"/api-reference/engagement/moderate-a-comment"},{"title":"Write a comment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/comments/create","href":"/api-reference/engagement/write-a-comment"},{"title":"Delete a comment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/comments/delete","href":"/api-reference/engagement/delete-a-comment"},{"title":"Reply to a comment in the thread","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/comments/public-reply","href":"/api-reference/engagement/reply-to-a-comment-in-the-thread"},{"title":"Reply to a commenter privately","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/comments/reply","href":"/api-reference/engagement/reply-to-a-commenter-privately"},{"title":"List DM conversations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/engagement/dms/conversations","href":"/api-reference/engagement/list-dm-conversations"},{"title":"Send a direct message","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/engagement/dms/send","href":"/api-reference/engagement/send-a-direct-message"},{"title":"List media that can be engaged with","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/engagement/media","href":"/api-reference/engagement/list-media-that-can-be-engaged-with"}]},{"group":"ffmpeg","pages":[{"title":"Submit a video-processing job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/ffmpeg/jobs","href":"/api-reference/ffmpeg/submit-a-video-processing-job"},{"title":"Poll a job","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/ffmpeg/jobs/{id}","href":"/api-reference/ffmpeg/poll-a-job"},{"title":"Download the processed file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/ffmpeg/jobs/{id}/result","href":"/api-reference/ffmpeg/download-the-processed-file"}]},{"group":"gbp","pages":[{"title":"List Google Business locations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/gbp/locations","href":"/api-reference/gbp/list-google-business-locations"},{"title":"Read Google reviews","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/gbp/reviews","href":"/api-reference/gbp/read-google-reviews"},{"title":"Reply to a Google review","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/gbp/reviews/reply","href":"/api-reference/gbp/reply-to-a-google-review"}]},{"group":"health","pages":[{"title":"Liveness check","description":"Returns `ok: true` and the server time when the API is reachable. No API key needed.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/health","href":"/api-reference/health/liveness-check"}]},{"group":"posts","pages":[{"title":"Publish a document post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/document","href":"/api-reference/posts/publish-a-document-post"},{"title":"List past posts","description":"Posts this account published through the API, newest first, with each post's type, `platforms`, `request_id` and outcome (`completed`, `draft`, `partial`, `failed`, `canceled` or `unknown`). `limit` defaults to 20 and is capped at 100.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/posts/history","href":"/api-reference/posts/list-past-posts"},{"title":"Publish a photo post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/photos","href":"/api-reference/posts/publish-a-photo-post"},{"title":"Retry a failed post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/retry","href":"/api-reference/posts/retry-a-failed-post"},{"title":"Read the outcome of a post","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/posts/status","href":"/api-reference/posts/read-the-outcome-of-a-post"},{"title":"Publish a text post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/text","href":"/api-reference/posts/publish-a-text-post"},{"title":"Remove a published post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/unpublish","href":"/api-reference/posts/remove-a-published-post"},{"title":"Publish a video post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/posts/video","href":"/api-reference/posts/publish-a-video-post"}]},{"group":"profiles","pages":[{"title":"List brand profiles","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/profiles","href":"/api-reference/profiles/list-brand-profiles"}]},{"group":"queue","pages":[{"title":"Read the next free queue slot","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/queue/next-slot","href":"/api-reference/queue/read-the-next-free-queue-slot"},{"title":"Preview the next queue slots","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/queue/preview","href":"/api-reference/queue/preview-the-next-queue-slots"},{"title":"Read queue settings","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/queue/settings","href":"/api-reference/queue/read-queue-settings"},{"title":"Update queue settings","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/queue/settings","href":"/api-reference/queue/update-queue-settings"}]},{"group":"schedule","pages":[{"title":"List scheduled jobs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/schedule","href":"/api-reference/schedule/list-scheduled-jobs"},{"title":"Cancel a scheduled job","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/schedule/{job_id}","href":"/api-reference/schedule/cancel-a-scheduled-job"},{"title":"Reschedule or edit a scheduled job","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/schedule/{job_id}","href":"/api-reference/schedule/reschedule-or-edit-a-scheduled-job"}]},{"group":"status","pages":[{"title":"Service status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/status","href":"/api-reference/status/service-status"}]},{"group":"tiktok_music","pages":[{"title":"Search TikTok music","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/tiktok/music/search","href":"/api-reference/tiktok_music/search-tiktok-music"},{"title":"TikTok music charts","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/tiktok/music/trending","href":"/api-reference/tiktok_music/tiktok-music-charts"}]},{"group":"usage","pages":[{"title":"Read plan limits and usage","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/usage","href":"/api-reference/usage/read-plan-limits-and-usage"}]}]}]}]},"basePath":"","title":"Publish a document post - MADIAD Hub","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}