Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer’s media_ref in a post’s media.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PostMesh","description":"How PostMesh works: write one post, check it against every network's rules, and publish or schedule it to 12 social networks.","colors":{"primary":"#4A6400","light":"#D4FF5A","dark":"#4A6400"},"logo":{"light":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/light.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=c13168a50d17ec8f05a48af736f712b5","dark":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/dark.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=afac489a8efcd10bd280213baef858cb","href":"https://postmesh.app"},"favicon":"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/favicon.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=69a8d816d5039e88c91fb6d1f5d21933","appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"href":"https://postmesh.app/pricing","label":"Pricing"},{"href":"https://postmesh.app/support","label":"Support"}],"primary":{"type":"button","label":"Start 7-day trial","href":"https://postmesh.app/signup"}},"footer":{"socials":{"discord":"https://discord.com/invite/wYh5fTVEFs"},"links":[{"header":"PostMesh","items":[{"label":"Home","href":"https://postmesh.app"},{"label":"Pricing","href":"https://postmesh.app/pricing"},{"label":"Support","href":"https://postmesh.app/support"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://postmesh.app/legal/privacy"},{"label":"Terms","href":"https://postmesh.app/legal/terms"},{"label":"Data deletion","href":"https://postmesh.app/legal/data-deletion"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"og:site_name":"PostMesh","og:image":"https://postmesh.app/brand/social-card.png","twitter:card":"summary_large_image"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"post-mesh","hasAudioNarration":false,"actualSubdomain":"post-mesh","customDomains":["postmesh.app"],"gitSource":{"type":"github","owner":"foundrceo","repo":"postmesh","deployBranch":"main","contentDirectory":"mintlify","isPrivate":false,"mountPath":"","label":"","_id":"6adde4c7ae0dc487a60fb07d"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeaa73822b64b3f9ae937ee","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API reference","count":20},{"language":"default","tag":"Posts","count":7},{"language":"default","tag":"Automate","count":6},{"language":"default","tag":"Publishing","count":6},{"language":"default","tag":"Drafts","count":5},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Media","count":4},{"language":"default","tag":"Account","count":2},{"language":"default","tag":"Networks","count":2},{"language":"default","tag":"Accounts","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/media/add-a-file","slug":"/api-reference/media/add-a-file","pageMetadata":{"title":"Add a file","description":"Adds a file to your media library: send `path` once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or `url` for PostMesh to download it. Put the answer's media_ref in a post's media.\n\nNeeds an API key with the `media` scope.","deprecated":null,"version":null,"openapi":"/openapi.json post /media","href":"/api-reference/media/add-a-file","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Adds a file to your media library: send \", _jsx(_components.code, {\n children: \"path\"\n }), \" once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or \", _jsx(_components.code, {\n children: \"url\"\n }), \" for PostMesh to download it. Put the answer’s media_ref in a post’s media.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Needs an API key with the \", _jsx(_components.code, {\n children: \"media\"\n }), \" scope.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add a file","description":"Adds a file to your media library: send `path` once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or `url` for PostMesh to download it. Put the answer's media_ref in a post's media.\n\nNeeds an API key with the `media` scope.","deprecated":null,"version":null,"openapi":"/openapi.json post /media","href":"/api-reference/media/add-a-file","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createMedia","summary":"Add a file","description":"Adds a file to your media library: send `path` once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or `url` for PostMesh to download it. Put the answer's media_ref in a post's media.\n\nNeeds an API key with the `media` scope.","tags":["Media"],"x-postmesh-scope":"media","parameters":["abe00b88-4d1e-4027-a75c-89e780ffada9"],"requestBody":"f6103eca-6569-477c-b03a-74d25644efd6","responses":{"201":"a7bfa78a-41b6-40c7-9179-91a930b1cab9","400":"a7410529-f552-4066-9bf1-5fbfbe6f1ec1","401":"bf250727-305d-48ed-ac1c-581a95d3257a","402":"35d395a4-f2d4-4f4d-a381-7493226315b5","403":"5ada887b-ccef-4cc9-909f-61f3da112929","409":"3cae8677-48f4-44f1-9e6b-eb3a0c93f36d","422":"ad06a628-8c8f-4971-b5bf-1649e47fb262","429":"9fea8e2c-ea2b-4894-9d5c-c8b427651b29","503":"c68cfbfc-ae16-402f-bd92-7e0326cf2aa3"},"method":"post","type":"path","servers":["5f3f6a58-0ee7-4c08-afb8-67d72ede46bb"],"security":["b99d229e-906d-4004-b947-561338ff7df8"],"path":"/media","baseUrlOptions":["https://postmesh.app/api/v1"],"title":"Add a file","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"abe00b88-4d1e-4027-a75c-89e780ffada9":{"name":"Idempotency-Key","in":"header","required":false,"description":"Makes a retry safe: the same key within 24 hours answers with the first request's result. Up to 255 printable characters.","schema":{"type":"string","minLength":1,"maxLength":255,"isRequired":false,"description":"Makes a retry safe: the same key within 24 hours answers with the first request's result. Up to 255 printable characters.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Adds a file to your media library: one you uploaded (path), or one PostMesh downloads (url).","required":["path"],"properties":{"path":{"type":"string","minLength":1,"maxLength":512,"description":"The path POST /media/uploads gave, once the file is uploaded.","isRequired":true,"uniqueKey":"oneOf.0.path","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Adds a file to your media library: one you uploaded (path), or one PostMesh downloads (url).","required":["url"],"properties":{"url":{"type":"string","maxLength":2048,"format":"uri","description":"A public https link to an image or video, up to 80 MB.","isRequired":true,"uniqueKey":"oneOf.1.url","typeLabel":"string\u003curi>"},"name":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"oneOf.1.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"path":"\u003cstring>","name":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a7bfa78a-41b6-40c7-9179-91a930b1cab9":{"description":"Added.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"The media library id, for media_ids. Null when the file isn't in the library.","format":"uuid","isRequired":true,"uniqueKey":"media.id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"The media library id, for media_ids. Null when the file isn't in the library.","isRequired":true,"uniqueKey":"media.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"media.id","typeLabel":"string\u003cuuid> | null"},"media_ref":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"media.media_ref.path","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"media.media_ref.name","typeLabel":"string"},"mime_type":{"type":"string","isRequired":true,"uniqueKey":"media.media_ref.mime_type","typeLabel":"string"}},"required":["path","name","mime_type"],"additionalProperties":false,"description":"Put this in a post's media.","isRequired":true,"uniqueKey":"media.media_ref","typeLabel":"object"},"kind":{"type":"string","enum":["image","video"],"uniqueKey":"media.kind","typeLabel":"enum\u003cstring>"},"size_bytes":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"uniqueKey":"media.size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"media.size_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"media.size_bytes","typeLabel":"integer | null"},"width":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"uniqueKey":"media.width.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"media.width.oneOf.1","typeLabel":"null"}],"uniqueKey":"media.width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"uniqueKey":"media.height.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"media.height.oneOf.1","typeLabel":"null"}],"uniqueKey":"media.height","typeLabel":"integer | null"},"duration_ms":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"uniqueKey":"media.duration_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"media.duration_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"media.duration_ms","typeLabel":"integer | null"},"alt_text":{"type":"string","uniqueKey":"media.alt_text","typeLabel":"string"},"source":{"type":"string","enum":["upload","api","clip_factory","ai_image"],"uniqueKey":"media.source","typeLabel":"enum\u003cstring>"},"url":{"oneOf":[{"type":"string","description":"A short-lived link to view the file.","uniqueKey":"media.url.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short-lived link to view the file.","uniqueKey":"media.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"media.url","typeLabel":"string | null"},"duplicate":{"description":"The library had this file already: media_ref is that copy.","type":"boolean","const":true,"uniqueKey":"media.duplicate","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","uniqueKey":"media.created_at","typeLabel":"string\u003cdate-time>"}},"required":["id","media_ref"],"additionalProperties":false,"description":"A file in your media library.","isRequired":true,"uniqueKey":"media","typeLabel":"object"}},"required":["media"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"media":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","media_ref":{"path":"\u003cstring>","name":"\u003cstring>","mime_type":"\u003cstring>"},"kind":"image","size_bytes":0,"width":0,"height":0,"duration_ms":0,"alt_text":"\u003cstring>","source":"upload","url":"\u003cstring>","duplicate":true,"created_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a7410529-f552-4066-9bf1-5fbfbe6f1ec1":{"description":"The request was refused: a field is missing or invalid. `field` names it.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"bf250727-305d-48ed-ac1c-581a95d3257a":{"description":"No API key, or one that isn't valid any more.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"35d395a4-f2d4-4f4d-a381-7493226315b5":{"description":"Your plan doesn't include this, or it has ended.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"5ada887b-ccef-4cc9-909f-61f3da112929":{"description":"The key can't do this: it needs another scope (`code` is `api_key_scope`), or it is in approval mode.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"3cae8677-48f4-44f1-9e6b-eb3a0c93f36d":{"description":"The item changed since you read it, is being sent right now, or a request with this Idempotency-Key is still running.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"ad06a628-8c8f-4971-b5bf-1649e47fb262":{"description":"This Idempotency-Key was already used for a different request.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"9fea8e2c-ea2b-4894-9d5c-c8b427651b29":{"description":"Too many requests. Wait for `Retry-After` seconds.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"},"c68cfbfc-ae16-402f-bd92-7e0326cf2aa3":{"description":"PostMesh can't answer right now. Try again shortly.","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make in a minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the minute resets, in Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"What went wrong, in plain words.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to act on, such as invalid_request, rate_limited or idempotency_key_reused.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"field":{"description":"The request field that was refused.","type":"string","uniqueKey":"field","typeLabel":"string"},"retry_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"uniqueKey":"retry_after","typeLabel":"integer"}},"required":["error","code"],"additionalProperties":false,"description":"Every refusal looks like this.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","field":"\u003cstring>","retry_after":0}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b99d229e-906d-4004-b947-561338ff7df8":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from Settings, API \u0026 MCP: pm_live_...","scopes":[],"schemeName":"apiKey"}}},"servers":{"5f3f6a58-0ee7-4c08-afb8-67d72ede46bb":{"url":"https://postmesh.app/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from Settings, API \u0026 MCP: pm_live_...","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from Settings, API \u0026 MCP: pm_live_...","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"post-mesh","siteName":"PostMesh","title":"Add a file - PostMesh","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T03:32:13.980Z","originalFileLocation":"api-reference/media/add-a-file.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer\u0026#x27;s media_ref in a post\u0026#x27;s media. Needs an API key with the media scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PostMesh\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add a file - PostMesh\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer\u0026#x27;s media_ref in a post\u0026#x27;s media. Needs an API key with the media scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PostMesh\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://postmesh.app/docs/api-reference/media/add-a-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://postmesh.app/brand/social-card.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add a file - PostMesh\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer\u0026#x27;s media_ref in a post\u0026#x27;s media. Needs an API key with the media scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://postmesh.app/brand/social-card.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/post-mesh/axMwxHPtoH-R1iHz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PostMesh\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4A6400\">\u003clink data-mint-head rel=\"canonical\" href=\"https://postmesh.app/docs/api-reference/media/add-a-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/media/add-a-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://postmesh.app/#organization\",\"name\":\"PostMesh\",\"url\":\"https://postmesh.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/post-mesh/GTIDUtOl4fYRkpa7/logo/light.svg?fit=max\u0026auto=format\u0026n=GTIDUtOl4fYRkpa7\u0026q=85\u0026s=c13168a50d17ec8f05a48af736f712b5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://postmesh.app/docs#website\",\"name\":\"PostMesh\",\"url\":\"https://postmesh.app/docs\",\"publisher\":{\"@id\":\"https://postmesh.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://postmesh.app/docs/api-reference/media/add-a-file#webpage\",\"url\":\"https://postmesh.app/docs/api-reference/media/add-a-file\",\"name\":\"Add a file\",\"description\":\"Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer's media_ref in a post's media. Needs an API key with the media scope.\",\"dateModified\":\"2026-11-04T03:32:13.980Z\",\"isPartOf\":{\"@id\":\"https://postmesh.app/docs#website\"},\"breadcrumb\":{\"@id\":\"https://postmesh.app/docs/api-reference/media/add-a-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://postmesh.app/docs/api-reference/media/add-a-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://postmesh.app/docs/api-reference/accounts/who-you-are\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Media\",\"item\":\"https://postmesh.app/docs/api-reference/media/list-media\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add a file\",\"item\":\"https://postmesh.app/docs/api-reference/media/add-a-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://postmesh.app/docs/api-reference/media/add-a-file#apireference\",\"headline\":\"Add a file\",\"name\":\"Add a file\",\"description\":\"Adds a file to your media library: send path once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or url for PostMesh to download it. Put the answer's media_ref in a post's media. Needs an API key with the media scope.\",\"url\":\"https://postmesh.app/docs/api-reference/media/add-a-file\",\"mainEntityOfPage\":{\"@id\":\"https://postmesh.app/docs/api-reference/media/add-a-file#webpage\"},\"image\":\"https://postmesh.app/brand/social-card.png\",\"dateModified\":\"2026-11-04T03:32:13.980Z\",\"publisher\":{\"@id\":\"https://postmesh.app/#organization\"},\"isPartOf\":{\"@id\":\"https://postmesh.app/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PostMesh\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PostMesh","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"PostMesh docs","sidebarTitle":"Introduction","href":"/index"},{"title":"Quickstart: your first post to every network","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Connect Instagram, TikTok, YouTube and more","sidebarTitle":"Connect your accounts","href":"/connect-accounts"},{"title":"Plans, trial and billing","sidebarTitle":"Plans and billing","href":"/plans-and-billing"}]},{"group":"Publishing","pages":[{"title":"Different captions for each social network","sidebarTitle":"Captions per network","href":"/captions-per-network"},{"title":"Schedule posts to every network","sidebarTitle":"Schedule posts","href":"/schedule-posts"},{"title":"Pre-flight checks before every post","sidebarTitle":"Pre-flight checks","href":"/pre-flight-checks"},{"title":"Drafts and bulk CSV import","sidebarTitle":"Drafts and CSV import","href":"/drafts-and-csv-import"},{"title":"Send a post to your client for approval","sidebarTitle":"Client approvals","href":"/client-approvals"},{"title":"Why a post failed and how to retry it","sidebarTitle":"Fix a failed post","href":"/fix-a-failed-post"}]},{"group":"Networks","pages":[{"title":"Supported networks and what each takes","sidebarTitle":"All networks","href":"/networks"},{"title":"Post to Discord with a channel webhook","sidebarTitle":"Discord","href":"/discord"}]},{"group":"Automate","pages":[{"title":"Post to social media from Claude, Cursor and Codex (MCP)","sidebarTitle":"Connect an AI assistant","href":"/mcp-setup"},{"title":"MCP tool reference","sidebarTitle":"MCP tool reference","href":"/mcp-tools"},{"title":"API keys","sidebarTitle":"API keys","href":"/api-keys"},{"title":"Webhooks","sidebarTitle":"Webhooks","href":"/webhooks"},{"title":"AI Agent: draft posts for every network","sidebarTitle":"AI Agent","href":"/ai-agent"},{"title":"Clip Factory: short clips from a YouTube video","sidebarTitle":"Clip Factory","href":"/clip-factory"}]},{"group":"Account","pages":[{"title":"Analytics for posts sent from PostMesh","sidebarTitle":"Analytics","href":"/analytics"},{"title":"Export your data or delete your account","sidebarTitle":"Data and privacy","href":"/data-and-privacy"}]},{"group":"API reference","pages":[{"group":"Accounts","pages":[{"title":"Who you are","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/accounts/who-you-are"},{"title":"List connected accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts","href":"/api-reference/accounts/list-connected-accounts"}]},{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"/openapi.json get /posts","href":"/api-reference/posts/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts","href":"/api-reference/posts/create-a-post"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{id}","href":"/api-reference/posts/get-a-post"},{"title":"Delete a post from PostMesh","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{id}","href":"/api-reference/posts/delete-a-post-from-postmesh"},{"title":"Change a scheduled post","deprecated":null,"version":null,"openapi":"/openapi.json patch /posts/{id}","href":"/api-reference/posts/change-a-scheduled-post"},{"title":"Cancel a scheduled post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/cancel","href":"/api-reference/posts/cancel-a-scheduled-post"},{"title":"Retry a failed post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{id}/retry","href":"/api-reference/posts/retry-a-failed-post"}]},{"group":"Analytics","pages":[{"title":"Get a post's numbers","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{id}/analytics","href":"/api-reference/analytics/get-a-posts-numbers"},{"title":"Get analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics","href":"/api-reference/analytics/get-analytics"}]},{"group":"Drafts","pages":[{"title":"List drafts","deprecated":null,"version":null,"openapi":"/openapi.json get /drafts","href":"/api-reference/drafts/list-drafts"},{"title":"Create a draft","deprecated":null,"version":null,"openapi":"/openapi.json post /drafts","href":"/api-reference/drafts/create-a-draft"},{"title":"Get a draft","deprecated":null,"version":null,"openapi":"/openapi.json get /drafts/{id}","href":"/api-reference/drafts/get-a-draft"},{"title":"Delete a draft","deprecated":null,"version":null,"openapi":"/openapi.json delete /drafts/{id}","href":"/api-reference/drafts/delete-a-draft"},{"title":"Change a draft","deprecated":null,"version":null,"openapi":"/openapi.json patch /drafts/{id}","href":"/api-reference/drafts/change-a-draft"}]},{"group":"Media","pages":[{"title":"List media","description":"The files in your media library, newest first.\n\nNeeds an API key with the `read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /media","href":"/api-reference/media/list-media"},{"title":"Add a file","deprecated":null,"version":null,"openapi":"/openapi.json post /media","href":"/api-reference/media/add-a-file"},{"title":"Get a file","description":"One file in your media library.\n\nNeeds an API key with the `read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /media/{id}","href":"/api-reference/media/get-a-file"},{"title":"Get an upload link","deprecated":null,"version":null,"openapi":"/openapi.json post /media/uploads","href":"/api-reference/media/get-an-upload-link"}]}]}]},"basePath":"","title":"Add a file - PostMesh","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}