Downloads up to 10 public files and appends them to the post’s media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type’s size cap are refused. Each download must finish within 20 seconds. Only the types the post’s channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post’s media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can't include media. Change the post type to add media., before anything is downloaded.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"TryPost Docs","colors":{"primary":"#7c3aed","light":"#a78bfa","dark":"#7c3aed"},"logo":{"light":"https://mintcdn.com/trypostit/wOGHkV49KgmeL3Pv/logo/light.png?fit=max\u0026auto=format\u0026n=wOGHkV49KgmeL3Pv\u0026q=85\u0026s=3bfecc29aaa0b706b6fcbb1e4da1ff23","dark":"https://mintcdn.com/trypostit/W1TMxiUczHWA_qlv/logo/dark.png?fit=max\u0026auto=format\u0026n=W1TMxiUczHWA_qlv\u0026q=85\u0026s=1c20b862375f2893debd4931ce03bf70"},"favicon":"https://mintcdn.com/trypostit/W1TMxiUczHWA_qlv/favicon.png?fit=max\u0026auto=format\u0026n=W1TMxiUczHWA_qlv\u0026q=85\u0026s=06995a6b1a9c570f58c2807820a23731","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#faf8f5","dark":"#0a0a0a"}},"navbar":{"links":[{"href":"https://github.com/trypostit/trypost","label":"GitHub"}],"primary":{"type":"button","label":"Sign up on Cloud","href":"https://trypost.it"}},"footer":{"socials":{"x":"https://x.com/trypostit","github":"https://github.com/trypostit","youtube":"https://www.youtube.com/@trypostit","instagram":"https://www.instagram.com/trypost.it","discord":"https://trypost.it/discord"}},"integrations":{"posthog":{"apiKey":"phc_qZKcjfjndNDmU4k5KSfhsiSCjS9yGuVuFLYfqri0YG1","apiHost":"https://dt.trypost.it"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/trypostit/trypost"},{"anchor":"Discord","icon":"discord","href":"https://trypost.it/discord"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@trypostit"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trypostit","hasAudioNarration":false,"actualSubdomain":"trypostit","customDomains":["docs.trypost.it"],"gitSource":{"type":"github","owner":"trypostit","repo":"trypost-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aff3cdc8b67b28b9f2a6b0a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":92},{"language":"default","tag":"Knowledge Base","count":28},{"language":"default","tag":"Build with AI","count":20},{"language":"default","tag":"Setup Guides","count":18},{"language":"default","tag":"Documentation","count":18},{"language":"default","tag":"Platforms","count":13},{"language":"default","tag":"Settings","count":12},{"language":"default","tag":"Repurposes","count":11},{"language":"default","tag":"Channels","count":10},{"language":"default","tag":"Webhooks","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/media-and-uploads/attach-media-from-url","slug":"/api-reference/media-and-uploads/attach-media-from-url","pageMetadata":{"title":"Attach media from URL","description":"Downloads up to 10 public files and appends them to the post's media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type's size cap are refused. Each download must finish within 20 seconds. Only the types the post's channel accepts are kept. URLs that could not be attached are listed in `failed_urls`, and `failures` gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with `422` on `post` with `This post has already been processed and cannot be re-published. Duplicate it to try again.` Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (`GET /content-types`). On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (`x_poll`, `mastodon_poll` or `threads_poll`) takes no media: `422` on `urls` with `This post type can't include media. Change the post type to add media.`, before anything is downloaded.","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/media/from-url","href":"/api-reference/media-and-uploads/attach-media-from-url","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: [\"Downloads up to 10 public files and appends them to the post’s media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type’s size cap are refused. Each download must finish within 20 seconds. Only the types the post’s channel accepts are kept. URLs that could not be attached are listed in \", _jsx(_components.code, {\n children: \"failed_urls\"\n }), \", and \", _jsx(_components.code, {\n children: \"failures\"\n }), \" gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with \", _jsx(_components.code, {\n children: \"422\"\n }), \" on \", _jsx(_components.code, {\n children: \"post\"\n }), \" with \", _jsx(_components.code, {\n children: \"This post has already been processed and cannot be re-published. Duplicate it to try again.\"\n }), \" Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (\", _jsx(_components.code, {\n children: \"GET /content-types\"\n }), \"). On Pinterest and TikTok the content type is chosen again from the post’s media, as on create. A poll (\", _jsx(_components.code, {\n children: \"x_poll\"\n }), \", \", _jsx(_components.code, {\n children: \"mastodon_poll\"\n }), \" or \", _jsx(_components.code, {\n children: \"threads_poll\"\n }), \") takes no media: \", _jsx(_components.code, {\n children: \"422\"\n }), \" on \", _jsx(_components.code, {\n children: \"urls\"\n }), \" with \", _jsx(_components.code, {\n children: \"This post type can't include media. Change the post type to add media.\"\n }), \", before anything is downloaded.\"]\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":"Attach media from URL","description":"Downloads up to 10 public files and appends them to the post's media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type's size cap are refused. Each download must finish within 20 seconds. Only the types the post's channel accepts are kept. URLs that could not be attached are listed in `failed_urls`, and `failures` gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with `422` on `post` with `This post has already been processed and cannot be re-published. Duplicate it to try again.` Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (`GET /content-types`). On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (`x_poll`, `mastodon_poll` or `threads_poll`) takes no media: `422` on `urls` with `This post type can't include media. Change the post type to add media.`, before anything is downloaded.","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/media/from-url","href":"/api-reference/media-and-uploads/attach-media-from-url","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Media and uploads"],"summary":"Attach media from URL","operationId":"attachMediaFromUrl","description":"Downloads up to 10 public files and appends them to the post's media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type's size cap are refused. Each download must finish within 20 seconds. Only the types the post's channel accepts are kept. URLs that could not be attached are listed in `failed_urls`, and `failures` gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with `422` on `post` with `This post has already been processed and cannot be re-published. Duplicate it to try again.` Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (`GET /content-types`). On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (`x_poll`, `mastodon_poll` or `threads_poll`) takes no media: `422` on `urls` with `This post type can't include media. Change the post type to add media.`, before anything is downloaded.","requestBody":"b08b8b37-fbf5-48f0-b801-ff9c82439eaf","responses":{"200":"e81a9353-02e7-4ef6-b713-38eb273d8eff","401":"b6958894-1a9d-48e4-b66a-c9ea8522840d","402":"1ac73f88-e09a-49f9-ab8b-3e1cb41a0d35","403":"bd63c6bf-2a0e-4d84-8c08-369f784ee355","404":"63384254-3c84-4176-83ae-5ff1a8fe7d6a","409":"6bdc8709-4755-4f6c-ad49-dbd3aef6fcca","422":"5231c128-c9c8-4233-a47c-9c854456783b","429":"1ba435a2-c3de-46fd-a18f-485d40d88985"},"method":"post","type":"path","servers":["12f974bb-a63a-478b-8785-c5a221f1711b"],"security":["f1030732-2f07-4c2f-8585-f2b951e50a7b"],"path":"/posts/{post}/media/from-url","baseUrlOptions":["https://app.trypost.it/api"],"title":"Attach media from URL","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a1ad63a7-8fa1-418d-ad8d-212a5c2500b2":{"name":"post","in":"path","required":true,"description":"Post id. A post of another workspace returns `404`.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Post id. A post of another workspace returns `404`.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["urls"],"properties":{"urls":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public `http` or `https` URL whose host resolves.","isRequired":true,"uniqueKey":"urls.items.[INDEX].url","typeLabel":"string\u003curi>"},"alt":{"oneOf":[{"type":"string","maxLength":2000,"description":"Alt text. Applies to images, and to videos where the content type has `supports_video_alt_text`; ignored for a PDF. `meta.alt_text` wins when both are sent.","uniqueKey":"urls.items.[INDEX].alt.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2000,"description":"Alt text. Applies to images, and to videos where the content type has `supports_video_alt_text`; ignored for a PDF. `meta.alt_text` wins when both are sent.","uniqueKey":"urls.items.[INDEX].alt.oneOf.1","typeLabel":"null"}],"uniqueKey":"urls.items.[INDEX].alt","typeLabel":"string | null"},"meta":{"type":"object","description":"Editable settings of one media item. Other keys the server measured (for example `width`, `height`, `duration`) may also appear in responses.","properties":{"alt_text":{"type":"string","maxLength":2000,"description":"Accessibility description. Applies to images, and to videos where the content type has `supports_video_alt_text`; each network truncates it to its own cap.","uniqueKey":"urls.items.[INDEX].meta.alt_text","typeLabel":"string"},"user_tags":{"type":"array","maxItems":20,"description":"People tagged on an Instagram image.","items":{"type":"object","required":["username","x","y"],"properties":{"username":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$","description":"Public Instagram username. A leading `@` is dropped.","isRequired":true,"uniqueKey":"urls.items.[INDEX].meta.user_tags.items.[INDEX].username","typeLabel":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the left edge, 0 to 1.","isRequired":true,"uniqueKey":"urls.items.[INDEX].meta.user_tags.items.[INDEX].x","typeLabel":"number"},"y":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the top edge, 0 to 1.","isRequired":true,"uniqueKey":"urls.items.[INDEX].meta.user_tags.items.[INDEX].y","typeLabel":"number"}},"uniqueKey":"urls.items.[INDEX].meta.user_tags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"urls.items.[INDEX].meta.user_tags","typeLabel":"object[]"},"cover_offset_ms":{"type":"integer","minimum":0,"description":"Video frame used as the cover, in milliseconds from the start. Cannot pass the end of the video.","uniqueKey":"urls.items.[INDEX].meta.cover_offset_ms","typeLabel":"integer"},"cover":{"type":"object","description":"An image used as the video's cover instead of a frame. Only in `media[]` of `POST /posts`, `POST /posts/batch` and `PUT /posts/{post}`: the attach endpoints (`POST /posts/{post}/media/from-upload`, `POST /posts/{post}/media/from-url`) accept it but discard it. Only on content types with `supports_custom_video_cover` (`instagram_reel`, `youtube_short`); dropped on every other content type. In a request, give exactly one of `upload_token`, `url` or `id`, like a media item; anything else fails with `Choose an image for the video cover.` It must be a still image: a GIF, video or PDF fails with `The video cover must be a JPEG, PNG or WebP image.` The network crops it to the middle 9:16, so upload it at 9:16. In responses it is the stored image, a media item (`id`, `path`, `url`, `type`, `mime_type`, `size`, ...). On a YouTube Short it is set as the thumbnail once YouTube has processed the video; a channel that is not verified cannot take one.","properties":{"upload_token":{"type":"string","format":"uuid","description":"Token from `POST /uploads`.","uniqueKey":"urls.items.[INDEX].meta.cover.upload_token","typeLabel":"string\u003cuuid>"},"url":{"type":"string","format":"uri","maxLength":2048,"description":"Public `http` or `https` URL of the image itself.","uniqueKey":"urls.items.[INDEX].meta.cover.url","typeLabel":"string\u003curi>"},"id":{"type":"string","format":"uuid","description":"Id of a media item already in this workspace.","uniqueKey":"urls.items.[INDEX].meta.cover.id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"urls.items.[INDEX].meta.cover","typeLabel":"object"},"cover_source":{"type":"string","enum":["frame","image"],"description":"Where the cover comes from. `image`: the uploaded `cover` (the default when `cover` is sent without a source). `frame`: the frame at `cover_offset_ms`; on a YouTube Short, which takes no frame time, `cover` is then that frame's screenshot. A network that only takes a frame keeps `cover_offset_ms` and drops `cover`. Dropped when there is no `cover`, so it is also dropped by the attach endpoints, which discard `cover`.","uniqueKey":"urls.items.[INDEX].meta.cover_source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"urls.items.[INDEX].meta","typeLabel":"object"}},"uniqueKey":"urls.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"urls","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"urls":[{"url":"https://example.com/launch.jpg","alt":"Product launch banner","meta":{"user_tags":[{"username":"trypost.it","x":0.42,"y":0.6}]}},{"url":"https://example.com/teaser.mp4"}]},"examples":{"Example":{"title":"Example","value":{"urls":[{"url":"https://example.com/launch.jpg","alt":"Product launch banner","meta":{"user_tags":[{"username":"trypost.it","x":0.42,"y":0.6}]}},{"url":"https://example.com/teaser.mp4"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e81a9353-02e7-4ef6-b713-38eb273d8eff":{"description":"The post and the result of each URL.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","description":"A post on one channel. Posts created together from several channels are independent posts that share a `post_group_id`.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.id","typeLabel":"string\u003cuuid>"},"post_group_id":{"oneOf":[{"type":"string","format":"uuid","description":"Shared by the posts created in one batch.","uniqueKey":"post.post_group_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Shared by the posts created in one batch.","uniqueKey":"post.post_group_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.post_group_id","typeLabel":"string\u003cuuid> | null"},"author":{"oneOf":[{"type":"object","description":"A workspace member. Only the id and name are exposed.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.author.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"post.author.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"post.author.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"post.author.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.author","typeLabel":"object | null"},"content":{"oneOf":[{"type":"string","description":"Post text, stored as sent.","uniqueKey":"post.content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Post text, stored as sent.","uniqueKey":"post.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.content","typeLabel":"string | null"},"media":{"oneOf":[{"type":"array","items":{"type":"object","description":"A media item as stored on a post.","properties":{"id":{"type":"string","format":"uuid","description":"Media id. Pass it as `media[].id` to reuse the file on another post.","uniqueKey":"post.media.oneOf.0.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"path":{"type":"string","description":"Storage path, `medias/{uuid}.{ext}`.","uniqueKey":"post.media.oneOf.0.items.[INDEX].path","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Public URL of the file.","uniqueKey":"post.media.oneOf.0.items.[INDEX].url","typeLabel":"string\u003curi>"},"type":{"oneOf":[{"type":"string","enum":["image","video","document",null],"description":"`null` on older items stored without a type.","uniqueKey":"post.media.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["image","video","document",null],"description":"`null` on older items stored without a type.","uniqueKey":"post.media.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring> | null"},"mime_type":{"oneOf":[{"type":"string","uniqueKey":"post.media.oneOf.0.items.[INDEX].mime_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.media.oneOf.0.items.[INDEX].mime_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].mime_type","typeLabel":"string | null"},"original_filename":{"oneOf":[{"type":"string","uniqueKey":"post.media.oneOf.0.items.[INDEX].original_filename.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.media.oneOf.0.items.[INDEX].original_filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].original_filename","typeLabel":"string | null"},"size":{"oneOf":[{"type":"integer","description":"Size in bytes.","uniqueKey":"post.media.oneOf.0.items.[INDEX].size.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Size in bytes.","uniqueKey":"post.media.oneOf.0.items.[INDEX].size.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].size","typeLabel":"integer | null"},"meta":{"type":"object","description":"Editable settings of one media item. Other keys the server measured (for example `width`, `height`, `duration`) may also appear in responses.","properties":{"alt_text":{"type":"string","maxLength":2000,"description":"Accessibility description. Applies to images, and to videos where the content type has `supports_video_alt_text`; each network truncates it to its own cap.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.alt_text","typeLabel":"string"},"user_tags":{"type":"array","maxItems":20,"description":"People tagged on an Instagram image.","items":{"type":"object","required":["username","x","y"],"properties":{"username":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$","description":"Public Instagram username. A leading `@` is dropped.","isRequired":true,"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.user_tags.items.[INDEX].username","typeLabel":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the left edge, 0 to 1.","isRequired":true,"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.user_tags.items.[INDEX].x","typeLabel":"number"},"y":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the top edge, 0 to 1.","isRequired":true,"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.user_tags.items.[INDEX].y","typeLabel":"number"}},"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.user_tags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.user_tags","typeLabel":"object[]"},"cover_offset_ms":{"type":"integer","minimum":0,"description":"Video frame used as the cover, in milliseconds from the start. Cannot pass the end of the video.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover_offset_ms","typeLabel":"integer"},"cover":{"type":"object","description":"An image used as the video's cover instead of a frame. Only in `media[]` of `POST /posts`, `POST /posts/batch` and `PUT /posts/{post}`: the attach endpoints (`POST /posts/{post}/media/from-upload`, `POST /posts/{post}/media/from-url`) accept it but discard it. Only on content types with `supports_custom_video_cover` (`instagram_reel`, `youtube_short`); dropped on every other content type. In a request, give exactly one of `upload_token`, `url` or `id`, like a media item; anything else fails with `Choose an image for the video cover.` It must be a still image: a GIF, video or PDF fails with `The video cover must be a JPEG, PNG or WebP image.` The network crops it to the middle 9:16, so upload it at 9:16. In responses it is the stored image, a media item (`id`, `path`, `url`, `type`, `mime_type`, `size`, ...). On a YouTube Short it is set as the thumbnail once YouTube has processed the video; a channel that is not verified cannot take one.","properties":{"upload_token":{"type":"string","format":"uuid","description":"Token from `POST /uploads`.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover.upload_token","typeLabel":"string\u003cuuid>"},"url":{"type":"string","format":"uri","maxLength":2048,"description":"Public `http` or `https` URL of the image itself.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover.url","typeLabel":"string\u003curi>"},"id":{"type":"string","format":"uuid","description":"Id of a media item already in this workspace.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover.id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover","typeLabel":"object"},"cover_source":{"type":"string","enum":["frame","image"],"description":"Where the cover comes from. `image`: the uploaded `cover` (the default when `cover` is sent without a source). `frame`: the frame at `cover_offset_ms`; on a YouTube Short, which takes no frame time, `cover` is then that frame's screenshot. A network that only takes a frame keeps `cover_offset_ms` and drops `cover`. Dropped when there is no `cover`, so it is also dropped by the attach endpoints, which discard `cover`.","uniqueKey":"post.media.oneOf.0.items.[INDEX].meta.cover_source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"post.media.oneOf.0.items.[INDEX].meta","typeLabel":"object"},"source":{"oneOf":[{"type":"string","enum":["ai","unsplash","giphy","google_drive","google_photos","canva",null],"description":"Where the file came from in the app. Present only on items added from one of these sources.","uniqueKey":"post.media.oneOf.0.items.[INDEX].source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["ai","unsplash","giphy","google_drive","google_photos","canva",null],"description":"Where the file came from in the app. Present only on items added from one of these sources.","uniqueKey":"post.media.oneOf.0.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].source","typeLabel":"enum\u003cstring> | null"},"source_meta":{"oneOf":[{"type":"object","description":"Details from that source. Present only when the source gave any.","uniqueKey":"post.media.oneOf.0.items.[INDEX].source_meta.oneOf.0","typeLabel":"object"},{"type":"null","description":"Details from that source. Present only when the source gave any.","uniqueKey":"post.media.oneOf.0.items.[INDEX].source_meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media.oneOf.0.items.[INDEX].source_meta","typeLabel":"object | null"}},"examples":[{"id":"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f","path":"medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","url":"https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","type":"image","mime_type":"image/jpeg","original_filename":"launch.jpg","size":482113,"meta":{"width":1080,"height":1350,"alt_text":"Product launch banner"}}],"uniqueKey":"post.media.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"post.media.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","description":"A media item as stored on a post.","properties":{"id":{"type":"string","format":"uuid","description":"Media id. Pass it as `media[].id` to reuse the file on another post."},"path":{"type":"string","description":"Storage path, `medias/{uuid}.{ext}`."},"url":{"type":"string","format":"uri","description":"Public URL of the file."},"type":{"oneOf":[{"type":"string","enum":["image","video","document",null],"description":"`null` on older items stored without a type."},{"type":"null","enum":["image","video","document",null],"description":"`null` on older items stored without a type."}]},"mime_type":{"oneOf":[{"type":"string"},{"type":"null"}]},"original_filename":{"oneOf":[{"type":"string"},{"type":"null"}]},"size":{"oneOf":[{"type":"integer","description":"Size in bytes."},{"type":"null","description":"Size in bytes."}]},"meta":{"type":"object","description":"Editable settings of one media item. Other keys the server measured (for example `width`, `height`, `duration`) may also appear in responses.","properties":{"alt_text":{"type":"string","maxLength":2000,"description":"Accessibility description. Applies to images, and to videos where the content type has `supports_video_alt_text`; each network truncates it to its own cap."},"user_tags":{"type":"array","maxItems":20,"description":"People tagged on an Instagram image.","items":{"type":"object","required":["username","x","y"],"properties":{"username":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$","description":"Public Instagram username. A leading `@` is dropped."},"x":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the left edge, 0 to 1."},"y":{"type":"number","minimum":0,"maximum":1,"description":"Offset from the top edge, 0 to 1."}}}},"cover_offset_ms":{"type":"integer","minimum":0,"description":"Video frame used as the cover, in milliseconds from the start. Cannot pass the end of the video."},"cover":{"type":"object","description":"An image used as the video's cover instead of a frame. Only in `media[]` of `POST /posts`, `POST /posts/batch` and `PUT /posts/{post}`: the attach endpoints (`POST /posts/{post}/media/from-upload`, `POST /posts/{post}/media/from-url`) accept it but discard it. Only on content types with `supports_custom_video_cover` (`instagram_reel`, `youtube_short`); dropped on every other content type. In a request, give exactly one of `upload_token`, `url` or `id`, like a media item; anything else fails with `Choose an image for the video cover.` It must be a still image: a GIF, video or PDF fails with `The video cover must be a JPEG, PNG or WebP image.` The network crops it to the middle 9:16, so upload it at 9:16. In responses it is the stored image, a media item (`id`, `path`, `url`, `type`, `mime_type`, `size`, ...). On a YouTube Short it is set as the thumbnail once YouTube has processed the video; a channel that is not verified cannot take one.","properties":{"upload_token":{"type":"string","format":"uuid","description":"Token from `POST /uploads`."},"url":{"type":"string","format":"uri","maxLength":2048,"description":"Public `http` or `https` URL of the image itself."},"id":{"type":"string","format":"uuid","description":"Id of a media item already in this workspace."}}},"cover_source":{"type":"string","enum":["frame","image"],"description":"Where the cover comes from. `image`: the uploaded `cover` (the default when `cover` is sent without a source). `frame`: the frame at `cover_offset_ms`; on a YouTube Short, which takes no frame time, `cover` is then that frame's screenshot. A network that only takes a frame keeps `cover_offset_ms` and drops `cover`. Dropped when there is no `cover`, so it is also dropped by the attach endpoints, which discard `cover`."}}},"source":{"oneOf":[{"type":"string","enum":["ai","unsplash","giphy","google_drive","google_photos","canva",null],"description":"Where the file came from in the app. Present only on items added from one of these sources."},{"type":"null","enum":["ai","unsplash","giphy","google_drive","google_photos","canva",null],"description":"Where the file came from in the app. Present only on items added from one of these sources."}]},"source_meta":{"oneOf":[{"type":"object","description":"Details from that source. Present only when the source gave any."},{"type":"null","description":"Details from that source. Present only when the source gave any."}]}},"examples":[{"id":"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f","path":"medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","url":"https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","type":"image","mime_type":"image/jpeg","original_filename":"launch.jpg","size":482113,"meta":{"width":1080,"height":1350,"alt_text":"Product launch banner"}}]},"uniqueKey":"post.media.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.media","typeLabel":"object[] | null"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","failed"],"description":"Lifecycle of the post in TryPost. `pending_approval` is a post a member who needs approval asked to schedule or publish. The outcome on the network is `publish_status`.","uniqueKey":"post.status","typeLabel":"enum\u003cstring>"},"schedule_mode":{"oneOf":[{"type":"string","enum":["queue","custom",null],"description":"`queue`: the post holds a slot of the channel's posting schedule. `custom`: it is scheduled at its own time.","uniqueKey":"post.schedule_mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["queue","custom",null],"description":"`queue`: the post holds a slot of the channel's posting schedule. `custom`: it is scheduled at its own time.","uniqueKey":"post.schedule_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.schedule_mode","typeLabel":"enum\u003cstring> | null"},"scheduled_at":{"oneOf":[{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.scheduled_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.scheduled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.scheduled_at","typeLabel":"string | null"},"published_at":{"oneOf":[{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.published_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.published_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.published_at","typeLabel":"string | null"},"approval_requested_by":{"oneOf":[{"type":"object","description":"Who asked for approval (not always the author).","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.approval_requested_by.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"post.approval_requested_by.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"post.approval_requested_by.oneOf.0","typeLabel":"object"},{"type":"null","description":"Who asked for approval (not always the author).","uniqueKey":"post.approval_requested_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.approval_requested_by","typeLabel":"object | null"},"approval_requested_at":{"oneOf":[{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.approval_requested_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.approval_requested_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.approval_requested_at","typeLabel":"string | null"},"approved_by":{"oneOf":[{"type":"object","description":"A workspace member. Only the id and name are exposed.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.approved_by.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"post.approved_by.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"post.approved_by.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"post.approved_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.approved_by","typeLabel":"object | null"},"approved_at":{"oneOf":[{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.approved_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.approved_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.approved_at","typeLabel":"string | null"},"recurrence":{"oneOf":[{"type":"object","description":"Repeat rule, or `null`.","properties":{"interval":{"type":"integer","uniqueKey":"post.recurrence.oneOf.0.interval","typeLabel":"integer"},"frequency":{"type":"string","enum":["day","week","month","year"],"uniqueKey":"post.recurrence.oneOf.0.frequency","typeLabel":"enum\u003cstring>"},"remaining":{"oneOf":[{"type":"integer","description":"Repeats left after the next one.","uniqueKey":"post.recurrence.oneOf.0.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Repeats left after the next one.","uniqueKey":"post.recurrence.oneOf.0.remaining.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.recurrence.oneOf.0.remaining","typeLabel":"integer | null"}},"uniqueKey":"post.recurrence.oneOf.0","typeLabel":"object"},{"type":"null","description":"Repeat rule, or `null`.","properties":{"interval":{"type":"integer"},"frequency":{"type":"string","enum":["day","week","month","year"]},"remaining":{"oneOf":[{"type":"integer","description":"Repeats left after the next one."},{"type":"null","description":"Repeats left after the next one."}]}},"uniqueKey":"post.recurrence.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.recurrence","typeLabel":"object | null"},"origin":{"type":"string","enum":["trypost","network"],"description":"`network` for posts imported from the network (published outside TryPost).","uniqueKey":"post.origin","typeLabel":"enum\u003cstring>"},"publish_status":{"type":"string","enum":["pending","publishing","retrying","pending_review","published","failed","rejected","deleted"],"description":"Publishing state on the network. `pending` until the post is sent; `retrying` waits for a retry after a network limit or a temporary network problem (such as a LinkedIn post not yet ready for its comment); `pending_review` and `rejected` come from networks that review posts (Google Business); `deleted` means the post was published and then deleted on the network (`status` stays `published` and `platform_url` is kept).","uniqueKey":"post.publish_status","typeLabel":"enum\u003cstring>"},"platform":{"oneOf":[{"type":"string","description":"Network of the post's channel.","enum":["linkedin","linkedin-page","x","tiktok","youtube","facebook","instagram","instagram-facebook","threads","pinterest","bluesky","mastodon","telegram","discord","google_business"],"uniqueKey":"post.platform.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Network of the post's channel.","uniqueKey":"post.platform.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.platform","typeLabel":"enum\u003cstring> | null"},"content_type":{"oneOf":[{"type":"string","description":"Post format on one network. It must belong to the destination's network. `GET /content-types` lists the formats of each network with their media rules. Instagram and Facebook stories publish no text. A poll (`x_poll`, `mastodon_poll` or `threads_poll`) takes no media; its choices, and on X and Mastodon its length, are in `meta.poll`.","enum":["instagram_feed","instagram_reel","instagram_story","linkedin_post","linkedin_page_post","facebook_post","facebook_reel","facebook_story","tiktok_video","tiktok_photo","youtube_short","x_post","x_poll","threads_post","threads_ghost_post","threads_poll","pinterest_pin","pinterest_video_pin","pinterest_carousel","bluesky_post","mastodon_post","mastodon_poll","telegram_post","discord_message","google_business_post"],"uniqueKey":"post.content_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"post.content_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.content_type","typeLabel":"enum\u003cstring> | null"},"meta":{"oneOf":[{"type":"object","maxItems":0,"description":"Stored per-network settings (see `PlatformMeta`). Empty settings may serialize as an empty array.","uniqueKey":"post.meta.oneOf.0","typeLabel":"object"},{"type":"array","maxItems":0,"description":"Stored per-network settings (see `PlatformMeta`). Empty settings may serialize as an empty array.","uniqueKey":"post.meta.oneOf.1","typeLabel":"array"},{"type":"null","maxItems":0,"description":"Stored per-network settings (see `PlatformMeta`). Empty settings may serialize as an empty array.","uniqueKey":"post.meta.oneOf.2","typeLabel":"null"}],"uniqueKey":"post.meta","typeLabel":"object | array | null"},"platform_url":{"oneOf":[{"type":"string","description":"Link to the published post on the network.","uniqueKey":"post.platform_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link to the published post on the network.","uniqueKey":"post.platform_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.platform_url","typeLabel":"string | null"},"error_message":{"oneOf":[{"type":"string","description":"Why publishing failed, when it did.","uniqueKey":"post.error_message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why publishing failed, when it did.","uniqueKey":"post.error_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.error_message","typeLabel":"string | null"},"display_name":{"oneOf":[{"type":"string","description":"Account name, kept even after the account is disconnected.","uniqueKey":"post.display_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account name, kept even after the account is disconnected.","uniqueKey":"post.display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.display_name","typeLabel":"string | null"},"display_username":{"oneOf":[{"type":"string","uniqueKey":"post.display_username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.display_username.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.display_username","typeLabel":"string | null"},"display_avatar":{"oneOf":[{"type":"string","uniqueKey":"post.display_avatar.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.display_avatar.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.display_avatar","typeLabel":"string | null"},"social_account":{"oneOf":[{"type":"object","description":"The account, or `null` once it was removed (the `display_*` fields keep its name).","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.social_account.oneOf.0.id","typeLabel":"string\u003cuuid>"},"platform":{"type":"string","enum":["linkedin","linkedin-page","x","tiktok","youtube","facebook","instagram","instagram-facebook","threads","pinterest","bluesky","mastodon","telegram","discord","google_business"],"description":"Network of a social account. `linkedin-page` is a LinkedIn company page, `instagram-facebook` an Instagram account connected through a Facebook Page.","uniqueKey":"post.social_account.oneOf.0.platform","typeLabel":"enum\u003cstring>"},"display_name":{"oneOf":[{"type":"string","uniqueKey":"post.social_account.oneOf.0.display_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.social_account.oneOf.0.display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.social_account.oneOf.0.display_name","typeLabel":"string | null"},"username":{"oneOf":[{"type":"string","uniqueKey":"post.social_account.oneOf.0.username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"post.social_account.oneOf.0.username.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.social_account.oneOf.0.username","typeLabel":"string | null"},"status":{"type":"string","enum":["connected","disconnected","token_expired"],"uniqueKey":"post.social_account.oneOf.0.status","typeLabel":"enum\u003cstring>"},"has_posting_schedule":{"type":"boolean","description":"Whether the channel has posting times. Queueing a post (`queue`) needs them.","uniqueKey":"post.social_account.oneOf.0.has_posting_schedule","typeLabel":"boolean"},"timezone":{"type":"string","description":"IANA time zone of the channel. Queue slots and recurrence follow it.","uniqueKey":"post.social_account.oneOf.0.timezone","typeLabel":"string"},"posting_goal":{"oneOf":[{"type":"integer","description":"Posts per week the channel aims for.","uniqueKey":"post.social_account.oneOf.0.posting_goal.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Posts per week the channel aims for.","uniqueKey":"post.social_account.oneOf.0.posting_goal.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.social_account.oneOf.0.posting_goal","typeLabel":"integer | null"},"max_content_length":{"type":"integer","description":"Text limit of this account, in characters. An X account with long posts gets 25000.","uniqueKey":"post.social_account.oneOf.0.max_content_length","typeLabel":"integer"},"long_posts":{"type":"boolean","description":"Whether this X account can publish long posts.","uniqueKey":"post.social_account.oneOf.0.long_posts","typeLabel":"boolean"},"verified_badge":{"oneOf":[{"type":"string","enum":["blue","business","government",null],"description":"X checkmark; `null` on other networks or unverified accounts. A badge alone does not mean long posts: read `long_posts`.","uniqueKey":"post.social_account.oneOf.0.verified_badge.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["blue","business","government",null],"description":"X checkmark; `null` on other networks or unverified accounts. A badge alone does not mean long posts: read `long_posts`.","uniqueKey":"post.social_account.oneOf.0.verified_badge.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.social_account.oneOf.0.verified_badge","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"post.social_account.oneOf.0","typeLabel":"object"},{"type":"null","description":"The account, or `null` once it was removed (the `display_*` fields keep its name).","uniqueKey":"post.social_account.oneOf.1","typeLabel":"null"}],"uniqueKey":"post.social_account","typeLabel":"object | null"},"labels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"post.labels.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"post.labels.items.[INDEX].name","typeLabel":"string"},"color":{"type":"string","description":"Hex color, `#RRGGBB`.","examples":["#2563EB"],"uniqueKey":"post.labels.items.[INDEX].color","typeLabel":"string"},"created_at":{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","examples":["2026-09-01 10:00:00"],"uniqueKey":"post.labels.items.[INDEX].created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","examples":["2026-09-01 10:00:00"],"uniqueKey":"post.labels.items.[INDEX].updated_at","typeLabel":"string"}},"uniqueKey":"post.labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"post.labels","typeLabel":"object[]"},"created_at":{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"UTC, format `Y-m-d H:i:s`.","uniqueKey":"post.updated_at","typeLabel":"string"}},"examples":[{"id":"9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41","post_group_id":"9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03","author":{"id":"9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e","name":"Ana Souza"},"content":"We just shipped scheduled threads. Here is how they work.","media":[{"id":"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f","path":"medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","url":"https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","type":"image","mime_type":"image/jpeg","original_filename":"launch.jpg","size":482113,"meta":{"width":1080,"height":1350,"alt_text":"Product launch banner"}}],"status":"scheduled","schedule_mode":"custom","scheduled_at":"2026-10-12 14:00:00","published_at":null,"approval_requested_by":null,"approval_requested_at":null,"approved_by":null,"approved_at":null,"recurrence":null,"origin":"trypost","publish_status":"pending","platform":"x","content_type":"x_post","meta":{"thread_replies":[{"text":"2/ Replies publish under the first post.","media":[]}]},"platform_url":null,"error_message":null,"display_name":"TryPost","display_username":"trypostit","display_avatar":"https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg","social_account":{"id":"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54","platform":"x","display_name":"TryPost","username":"trypostit","status":"connected","has_posting_schedule":true,"timezone":"America/Sao_Paulo","posting_goal":5,"max_content_length":280,"long_posts":false,"verified_badge":null},"labels":[{"id":"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f","name":"Launch","color":"#2563EB","created_at":"2026-09-01 10:00:00","updated_at":"2026-09-01 10:00:00"}],"created_at":"2026-10-08 13:20:11","updated_at":"2026-10-08 13:20:11"}],"uniqueKey":"post","typeLabel":"object"},"attached_count":{"type":"integer","uniqueKey":"attached_count","typeLabel":"integer"},"failed_urls":{"type":"array","items":{"type":"string","uniqueKey":"failed_urls.items.[INDEX]","typeLabel":"string"},"uniqueKey":"failed_urls","typeLabel":"string[]"},"failures":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"failures.items.[INDEX].url","typeLabel":"string"},"reason":{"type":"string","enum":["unreachable","type_not_allowed","too_large","host_not_allowed"],"uniqueKey":"failures.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"failures.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"failures.items.[INDEX]","typeLabel":"object"},"uniqueKey":"failures","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"post":{"id":"9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41","post_group_id":"9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03","author":{"id":"9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e","name":"Ana Souza"},"content":"We just shipped scheduled threads. Here is how they work.","media":[{"id":"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f","path":"medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","url":"https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","type":"image","mime_type":"image/jpeg","original_filename":"launch.jpg","size":482113,"meta":{"width":1080,"height":1350,"alt_text":"Product launch banner"}}],"status":"scheduled","schedule_mode":"custom","scheduled_at":"2026-10-12 14:00:00","published_at":null,"approval_requested_by":null,"approval_requested_at":null,"approved_by":null,"approved_at":null,"recurrence":null,"origin":"trypost","publish_status":"pending","platform":"x","content_type":"x_post","meta":{"thread_replies":[{"text":"2/ Replies publish under the first post.","media":[]}]},"platform_url":null,"error_message":null,"display_name":"TryPost","display_username":"trypostit","display_avatar":"https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg","social_account":{"id":"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54","platform":"x","display_name":"TryPost","username":"trypostit","status":"connected","has_posting_schedule":true,"timezone":"America/Sao_Paulo","posting_goal":5,"max_content_length":280,"long_posts":false,"verified_badge":null},"labels":[{"id":"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f","name":"Launch","color":"#2563EB","created_at":"2026-09-01 10:00:00","updated_at":"2026-09-01 10:00:00"}],"created_at":"2026-10-08 13:20:11","updated_at":"2026-10-08 13:20:11"},"attached_count":1,"failed_urls":["https://example.com/teaser.mp4"],"failures":[{"url":"https://example.com/teaser.mp4","reason":"unreachable","message":"Could not fetch media from https://example.com/teaser.mp4."}]},"examples":{"Example":{"title":"Example","value":{"post":{"id":"9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41","post_group_id":"9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03","author":{"id":"9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e","name":"Ana Souza"},"content":"We just shipped scheduled threads. Here is how they work.","media":[{"id":"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f","path":"medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","url":"https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg","type":"image","mime_type":"image/jpeg","original_filename":"launch.jpg","size":482113,"meta":{"width":1080,"height":1350,"alt_text":"Product launch banner"}}],"status":"scheduled","schedule_mode":"custom","scheduled_at":"2026-10-12 14:00:00","published_at":null,"approval_requested_by":null,"approval_requested_at":null,"approved_by":null,"approved_at":null,"recurrence":null,"origin":"trypost","publish_status":"pending","platform":"x","content_type":"x_post","meta":{"thread_replies":[{"text":"2/ Replies publish under the first post.","media":[]}]},"platform_url":null,"error_message":null,"display_name":"TryPost","display_username":"trypostit","display_avatar":"https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg","social_account":{"id":"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54","platform":"x","display_name":"TryPost","username":"trypostit","status":"connected","has_posting_schedule":true,"timezone":"America/Sao_Paulo","posting_goal":5,"max_content_length":280,"long_posts":false,"verified_badge":null},"labels":[{"id":"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f","name":"Launch","color":"#2563EB","created_at":"2026-09-01 10:00:00","updated_at":"2026-09-01 10:00:00"}],"created_at":"2026-10-08 13:20:11","updated_at":"2026-10-08 13:20:11"},"attached_count":1,"failed_urls":["https://example.com/teaser.mp4"],"failures":[{"url":"https://example.com/teaser.mp4","reason":"unreachable","message":"Could not fetch media from https://example.com/teaser.mp4."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"b6958894-1a9d-48e4-b66a-c9ea8522840d":{"description":"Missing, invalid, revoked or expired API key. Bodies: `Unauthenticated.` (no key, or a key that is invalid or revoked), `Token expired.` (past its `expires_at`), `Token not found.` and `No workspace selected.` (the key is no longer bound to a workspace).","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Unauthenticated."},"examples":{"Example":{"title":"Example","value":{"message":"Unauthenticated."}}},"exampleType":"examples"}},"exampleType":"examples"},"1ac73f88-e09a-49f9-ab8b-3e1cb41a0d35":{"description":"TryPost Cloud only: the workspace's account has no active subscription or trial. Body: `{\"message\": \"Active subscription required.\"}`.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Active subscription required."},"examples":{"Example":{"title":"Example","value":{"message":"Active subscription required."}}},"exampleType":"examples"}},"exampleType":"examples"},"bd63c6bf-2a0e-4d84-8c08-369f784ee355":{"description":"The request is not allowed. API keys work only for workspace admins (the account owner or a member marked as admin): otherwise every request returns `Insufficient workspace permissions.`. Other bodies: `Workspace access denied.` (the key's user left the workspace) and `Personal access token required.` (an MCP OAuth token was sent) and `This action is unauthorized.` (the note belongs to another member).","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"63384254-3c84-4176-83ae-5ff1a8fe7d6a":{"description":"The resource does not exist in this workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6bdc8709-4755-4f6c-ad49-dbd3aef6fcca":{"description":"Another change to this post or its channel's queue is in progress. Retry.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5231c128-c9c8-4233-a47c-9c854456783b":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"1ba435a2-c3de-46fd-a18f-485d40d88985":{"description":"Rate limit exceeded. Limits: 60 requests per minute per workspace.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","const":"rate_limit_exceeded","uniqueKey":"name","typeLabel":"string"},"message":{"type":"string","examples":["Rate limit exceeded. Please retry after 30 seconds."],"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"rate_limit_exceeded","message":"Rate limit exceeded. Please retry after 30 seconds."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f1030732-2f07-4c2f-8585-f2b951e50a7b":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Workspace API key from Settings → API Keys.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"12f974bb-a63a-478b-8785-c5a221f1711b":{"url":"https://app.trypost.it/api","description":"TryPost Cloud"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace API key from Settings → API Keys.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key from Settings → API Keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"trypostit","siteName":"TryPost Docs","title":"Attach media from URL - TryPost Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T18:16:08.138Z","originalFileLocation":"api-reference/media-and-uploads/attach-media-from-url.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Downloads up to 10 public files and appends them to the post\u0026#x27;s media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type\u0026#x27;s size cap are refused. Each download must finish within 20 seconds. Only the types the post\u0026#x27;s channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post\u0026#x27;s media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can\u0026#x27;t include media. Change the post type to add media., before anything is downloaded.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TryPost Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_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/trypostit/myPBspfpFdEcFxqM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Attach media from URL - TryPost Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Downloads up to 10 public files and appends them to the post\u0026#x27;s media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type\u0026#x27;s size cap are refused. Each download must finish within 20 seconds. Only the types the post\u0026#x27;s channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post\u0026#x27;s media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can\u0026#x27;t include media. Change the post type to add media., before anything is downloaded.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TryPost Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trypostit.mintlify.site/_mintlify/api/og/v2?division=Media+and+uploads\u0026amp;title=Attach+media+from+URL\u0026amp;description=Downloads+up+to+10+public+files+and+appends+them+to+the+post%27s+media.+Each+URL+must+serve+the+file+itself%3A+redirects+are+not+followed%2C+and+web+pages%2C+private-ne\u0026amp;theme=0bfb78a8df9822533e327c6d\u0026amp;signature=3b7b87e57745928fa22d17b2497b3b167d451ea9e6c4ae8a8e69a0a6a95d61e5\">\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=\"Attach media from URL - TryPost Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Downloads up to 10 public files and appends them to the post\u0026#x27;s media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type\u0026#x27;s size cap are refused. Each download must finish within 20 seconds. Only the types the post\u0026#x27;s channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post\u0026#x27;s media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can\u0026#x27;t include media. Change the post type to add media., before anything is downloaded.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trypostit.mintlify.site/_mintlify/api/og/v2?division=Media+and+uploads\u0026amp;title=Attach+media+from+URL\u0026amp;description=Downloads+up+to+10+public+files+and+appends+them+to+the+post%27s+media.+Each+URL+must+serve+the+file+itself%3A+redirects+are+not+followed%2C+and+web+pages%2C+private-ne\u0026amp;theme=0bfb78a8df9822533e327c6d\u0026amp;signature=3b7b87e57745928fa22d17b2497b3b167d451ea9e6c4ae8a8e69a0a6a95d61e5\">\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/trypostit/myPBspfpFdEcFxqM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TryPost Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7c3aed\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/media-and-uploads/attach-media-from-url.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trypost.it/#organization\",\"name\":\"TryPost Docs\",\"url\":\"https://docs.trypost.it\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trypostit/wOGHkV49KgmeL3Pv/logo/light.png?fit=max\u0026auto=format\u0026n=wOGHkV49KgmeL3Pv\u0026q=85\u0026s=3bfecc29aaa0b706b6fcbb1e4da1ff23\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trypost.it#website\",\"name\":\"TryPost Docs\",\"url\":\"https://docs.trypost.it\",\"publisher\":{\"@id\":\"https://docs.trypost.it/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url#webpage\",\"url\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url\",\"name\":\"Attach media from URL\",\"description\":\"Downloads up to 10 public files and appends them to the post's media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type's size cap are refused. Each download must finish within 20 seconds. Only the types the post's channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can't include media. Change the post type to add media., before anything is downloaded.\",\"dateModified\":\"2026-11-19T18:16:08.138Z\",\"isPartOf\":{\"@id\":\"https://docs.trypost.it#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Media and uploads\",\"item\":\"https://docs.trypost.it/api-reference/media-and-uploads/upload-media\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Attach media from URL\",\"item\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url#apireference\",\"headline\":\"Attach media from URL\",\"name\":\"Attach media from URL\",\"description\":\"Downloads up to 10 public files and appends them to the post's media. Each URL must serve the file itself: redirects are not followed, and web pages, private-network hosts and files over the type's size cap are refused. Each download must finish within 20 seconds. Only the types the post's channel accepts are kept. URLs that could not be attached are listed in failed_urls, and failures gives the reason of each. Posts that are publishing, published or failed cannot take media: when a file was downloaded, the request fails with 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (x_poll, mastodon_poll or threads_poll) takes no media: 422 on urls with This post type can't include media. Change the post type to add media., before anything is downloaded.\",\"url\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trypost.it/api-reference/media-and-uploads/attach-media-from-url#webpage\"},\"dateModified\":\"2026-11-19T18:16:08.138Z\",\"publisher\":{\"@id\":\"https://docs.trypost.it/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trypost.it#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TryPost Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TryPost Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/media-and-uploads/attach-media-from-url.md","siteName":"TryPost Docs","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/trypostit/trypost"},{"anchor":"Discord","icon":"discord","href":"https://trypost.it/discord"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@trypostit"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"book-open","href":"/api-reference/introduction"},{"title":"Posting","icon":"paper-plane","href":"/api-reference/guides/posting"},{"title":"Media uploads","icon":"image","href":"/api-reference/guides/media-uploads"}]},{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"/openapi.json get /posts","href":"/api-reference/posts/list-posts"},{"title":"Create post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts","href":"/api-reference/posts/create-post"},{"title":"Create posts in batch","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/batch","href":"/api-reference/posts/create-posts-in-batch"},{"title":"Get post","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}","href":"/api-reference/posts/get-post"},{"title":"Update post","deprecated":null,"version":null,"openapi":"/openapi.json put /posts/{post}","href":"/api-reference/posts/update-post"},{"title":"Delete post","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{post}","href":"/api-reference/posts/delete-post"},{"title":"Get post metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}/metrics","href":"/api-reference/posts/get-post-metrics"},{"title":"Get post preview","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}/preview","href":"/api-reference/posts/get-post-preview"}]},{"group":"Post notes","pages":[{"title":"List post notes","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}/notes","href":"/api-reference/post-notes/list-post-notes"},{"title":"Create post note","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/notes","href":"/api-reference/post-notes/create-post-note"},{"title":"Get post note","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}/notes/{note}","href":"/api-reference/post-notes/get-post-note"},{"title":"Update post note","deprecated":null,"version":null,"openapi":"/openapi.json put /posts/{post}/notes/{note}","href":"/api-reference/post-notes/update-post-note"},{"title":"Delete post note","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{post}/notes/{note}","href":"/api-reference/post-notes/delete-post-note"},{"title":"List post note mentionables","deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}/notes/mentionables","href":"/api-reference/post-notes/list-post-note-mentionables"},{"title":"Add post note reaction","deprecated":null,"version":null,"openapi":"/openapi.json put /posts/{post}/notes/{note}/reactions","href":"/api-reference/post-notes/add-post-note-reaction"},{"title":"Remove post note reaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{post}/notes/{note}/reactions","href":"/api-reference/post-notes/remove-post-note-reaction"}]},{"group":"Approvals","pages":[{"title":"Approve post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/approve","href":"/api-reference/approvals/approve-post"},{"title":"Reject post","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/reject","href":"/api-reference/approvals/reject-post"}]},{"group":"Recurrence","pages":[{"title":"Set post recurrence","deprecated":null,"version":null,"openapi":"/openapi.json patch /posts/{post}/recurrence","href":"/api-reference/recurrence/set-post-recurrence"},{"title":"Remove post recurrence","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{post}/recurrence","href":"/api-reference/recurrence/remove-post-recurrence"}]},{"group":"Media and uploads","pages":[{"title":"Upload media","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/media","href":"/api-reference/media-and-uploads/upload-media"},{"title":"Attach media from upload","description":"Appends a file uploaded earlier (`POST /uploads` or a signed upload URL) to the post's media. The token is spent by this post. An unknown or expired token fails with `422` on `upload_token`: `This upload expired. Add the file again.` A type the post's channel does not accept fails with `422`. Posts that are publishing, published or failed cannot take media: `422` on `post` with `This post has already been processed and cannot be re-published. Duplicate it to try again.` On Pinterest and TikTok the content type is chosen again from the post's media, as on create. A poll (`x_poll`, `mastodon_poll` or `threads_poll`) takes no media: `422` on `media` with `This post type can't include media. Change the post type to add media.`","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/media/from-upload","href":"/api-reference/media-and-uploads/attach-media-from-upload"},{"title":"Attach media from URL","deprecated":null,"version":null,"openapi":"/openapi.json post /posts/{post}/media/from-url","href":"/api-reference/media-and-uploads/attach-media-from-url"},{"title":"Create upload","description":"Uploads one file as `multipart/form-data` without a post and returns an `upload_token`. Pass it as a media item (`media[].upload_token`) to `POST /posts`, `POST /posts/batch` or `PUT /posts/{post}`, or to `POST /posts/{post}/media/from-upload`, before `expires_at`. A token is spent by the first post that takes it; to put the same file on another post, pass that post's `media[].id`. Unused uploads are deleted after 24 hours. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (`GET /content-types`).","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads","href":"/api-reference/media-and-uploads/create-upload"},{"title":"Upload to signed URL","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads/{token}","href":"/api-reference/media-and-uploads/upload-to-signed-url"}]},{"group":"Social accounts","pages":[{"title":"List social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts","href":"/api-reference/social-accounts/list-social-accounts"},{"title":"List Pinterest boards","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts/{account}/boards","href":"/api-reference/social-accounts/list-pinterest-boards"},{"title":"Create Pinterest board","deprecated":null,"version":null,"openapi":"/openapi.json post /social-accounts/{account}/boards","href":"/api-reference/social-accounts/create-pinterest-board"},{"title":"List Discord channels","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts/{account}/channels","href":"/api-reference/social-accounts/list-discord-channels"},{"title":"Get TikTok creator info","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts/{account}/tiktok-creator-info","href":"/api-reference/social-accounts/get-tiktok-creator-info"},{"title":"Search Instagram audio","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts/{account}/instagram-audio","href":"/api-reference/social-accounts/search-instagram-audio"},{"title":"Get Instagram audio","deprecated":null,"version":null,"openapi":"/openapi.json get /social-accounts/{account}/instagram-audio/{audioId}","href":"/api-reference/social-accounts/get-instagram-audio"}]},{"group":"Channels","pages":[{"title":"Get posting schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /channels/{account}/posting-schedule","href":"/api-reference/channels/get-posting-schedule"},{"title":"Update posting schedule","deprecated":null,"version":null,"openapi":"/openapi.json put /channels/{account}/posting-schedule","href":"/api-reference/channels/update-posting-schedule"},{"title":"Generate posting schedule","deprecated":null,"version":null,"openapi":"/openapi.json post /channels/{account}/posting-schedule/generate","href":"/api-reference/channels/generate-posting-schedule"},{"title":"Copy posting schedule","deprecated":null,"version":null,"openapi":"/openapi.json post /channels/{account}/posting-schedule/copy","href":"/api-reference/channels/copy-posting-schedule"},{"title":"List free queue slots","deprecated":null,"version":null,"openapi":"/openapi.json get /channels/{account}/queue/slots","href":"/api-reference/channels/list-free-queue-slots"},{"title":"Reorder queue","deprecated":null,"version":null,"openapi":"/openapi.json put /channels/{account}/queue/order","href":"/api-reference/channels/reorder-queue"},{"title":"Move post to queue slot","deprecated":null,"version":null,"openapi":"/openapi.json put /channels/{account}/queue/slot","href":"/api-reference/channels/move-post-to-queue-slot"}]},{"group":"Ideas","pages":[{"title":"List ideas","deprecated":null,"version":null,"openapi":"/openapi.json get /ideas","href":"/api-reference/ideas/list-ideas"},{"title":"Create idea","deprecated":null,"version":null,"openapi":"/openapi.json post /ideas","href":"/api-reference/ideas/create-idea"},{"title":"Delete ideas","deprecated":null,"version":null,"openapi":"/openapi.json delete /ideas","href":"/api-reference/ideas/delete-ideas"},{"title":"Get idea","deprecated":null,"version":null,"openapi":"/openapi.json get /ideas/{idea}","href":"/api-reference/ideas/get-idea"},{"title":"Update idea","deprecated":null,"version":null,"openapi":"/openapi.json put /ideas/{idea}","href":"/api-reference/ideas/update-idea"},{"title":"Delete idea","deprecated":null,"version":null,"openapi":"/openapi.json delete /ideas/{idea}","href":"/api-reference/ideas/delete-idea"},{"title":"Duplicate idea","deprecated":null,"version":null,"openapi":"/openapi.json post /ideas/{idea}/duplicate","href":"/api-reference/ideas/duplicate-idea"},{"title":"Move idea","deprecated":null,"version":null,"openapi":"/openapi.json put /ideas/{idea}/move","href":"/api-reference/ideas/move-idea"}]},{"group":"Idea stages","pages":[{"title":"List idea stages","deprecated":null,"version":null,"openapi":"/openapi.json get /idea-stages","href":"/api-reference/idea-stages/list-idea-stages"},{"title":"Create idea stage","deprecated":null,"version":null,"openapi":"/openapi.json post /idea-stages","href":"/api-reference/idea-stages/create-idea-stage"},{"title":"Reorder idea stages","deprecated":null,"version":null,"openapi":"/openapi.json put /idea-stages/order","href":"/api-reference/idea-stages/reorder-idea-stages"},{"title":"Update idea stage","deprecated":null,"version":null,"openapi":"/openapi.json put /idea-stages/{ideaStage}","href":"/api-reference/idea-stages/update-idea-stage"},{"title":"Delete idea stage","deprecated":null,"version":null,"openapi":"/openapi.json delete /idea-stages/{ideaStage}","href":"/api-reference/idea-stages/delete-idea-stage"}]},{"group":"Analytics","pages":[{"title":"Get workspace analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics","href":"/api-reference/analytics/get-workspace-analytics"},{"title":"Get publication analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics/publications/{publication}","href":"/api-reference/analytics/get-publication-analytics"},{"title":"Get channel insights","deprecated":null,"version":null,"openapi":"/openapi.json get /channels/{account}/insights","href":"/api-reference/analytics/get-channel-insights"},{"title":"List channel post performance","deprecated":null,"version":null,"openapi":"/openapi.json get /channels/{account}/insights/publications","href":"/api-reference/analytics/list-channel-post-performance"}]},{"group":"Labels","pages":[{"title":"List labels","deprecated":null,"version":null,"openapi":"/openapi.json get /labels","href":"/api-reference/labels/list-labels"},{"title":"Create label","deprecated":null,"version":null,"openapi":"/openapi.json post /labels","href":"/api-reference/labels/create-label"},{"title":"Update label","deprecated":null,"version":null,"openapi":"/openapi.json put /labels/{label}","href":"/api-reference/labels/update-label"},{"title":"Delete label","deprecated":null,"version":null,"openapi":"/openapi.json delete /labels/{label}","href":"/api-reference/labels/delete-label"}]},{"group":"Signatures","pages":[{"title":"List signatures","deprecated":null,"version":null,"openapi":"/openapi.json get /signatures","href":"/api-reference/signatures/list-signatures"},{"title":"Create signature","deprecated":null,"version":null,"openapi":"/openapi.json post /signatures","href":"/api-reference/signatures/create-signature"},{"title":"Update signature","deprecated":null,"version":null,"openapi":"/openapi.json put /signatures/{signature}","href":"/api-reference/signatures/update-signature"},{"title":"Delete signature","deprecated":null,"version":null,"openapi":"/openapi.json delete /signatures/{signature}","href":"/api-reference/signatures/delete-signature"}]},{"group":"Workspace","pages":[{"title":"Get workspace","deprecated":null,"version":null,"openapi":"/openapi.json get /workspace","href":"/api-reference/workspace/get-workspace"}]},{"group":"API keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /api-keys","href":"/api-reference/api-keys/create-api-key"},{"title":"Delete API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /api-keys/{apiToken}","href":"/api-reference/api-keys/delete-api-key"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{webhook}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update webhook","deprecated":null,"version":null,"openapi":"/openapi.json put /webhooks/{webhook}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /webhooks/{webhook}","href":"/api-reference/webhooks/delete-webhook"},{"title":"List webhook logs","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{webhook}/logs","href":"/api-reference/webhooks/list-webhook-logs"},{"title":"Replay webhook log","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks/{webhook}/logs/{webhookLog}/replay","href":"/api-reference/webhooks/replay-webhook-log"},{"title":"Rotate webhook secret","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks/{webhook}/rotate-secret","href":"/api-reference/webhooks/rotate-webhook-secret"},{"title":"Send webhook test","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks/{webhook}/send-test","href":"/api-reference/webhooks/send-webhook-test"}]},{"group":"Repurposes","pages":[{"title":"List repurpose source formats","deprecated":null,"version":null,"openapi":"/openapi.json get /repurpose-source-formats","href":"/api-reference/repurposes/list-repurpose-source-formats"},{"title":"List repurposes","deprecated":null,"version":null,"openapi":"/openapi.json get /repurposes","href":"/api-reference/repurposes/list-repurposes"},{"title":"Create repurpose","deprecated":null,"version":null,"openapi":"/openapi.json post /repurposes","href":"/api-reference/repurposes/create-repurpose"},{"title":"Get repurpose","deprecated":null,"version":null,"openapi":"/openapi.json get /repurposes/{repurpose}","href":"/api-reference/repurposes/get-repurpose"},{"title":"Update repurpose","deprecated":null,"version":null,"openapi":"/openapi.json put /repurposes/{repurpose}","href":"/api-reference/repurposes/update-repurpose"},{"title":"Delete repurpose","deprecated":null,"version":null,"openapi":"/openapi.json delete /repurposes/{repurpose}","href":"/api-reference/repurposes/delete-repurpose"},{"title":"Activate repurpose","deprecated":null,"version":null,"openapi":"/openapi.json post /repurposes/{repurpose}/activate","href":"/api-reference/repurposes/activate-repurpose"},{"title":"Disable repurpose","deprecated":null,"version":null,"openapi":"/openapi.json post /repurposes/{repurpose}/disable","href":"/api-reference/repurposes/disable-repurpose"},{"title":"List repurpose items","deprecated":null,"version":null,"openapi":"/openapi.json get /repurposes/{repurpose}/items","href":"/api-reference/repurposes/list-repurpose-items"},{"title":"Pause repurpose","deprecated":null,"version":null,"openapi":"/openapi.json post /repurposes/{repurpose}/pause","href":"/api-reference/repurposes/pause-repurpose"},{"title":"Resume repurpose","deprecated":null,"version":null,"openapi":"/openapi.json post /repurposes/{repurpose}/resume","href":"/api-reference/repurposes/resume-repurpose"}]},{"group":"Platform","pages":[{"title":"List content types","deprecated":null,"version":null,"openapi":"/openapi.json get /content-types","href":"/api-reference/platform/list-content-types"}]}]},{"tab":"Build with AI","icon":"microchip-ai","pages":[{"title":"Build with AI","href":"/ai/introduction"}]},{"tab":"Knowledge Base","icon":"book","pages":[{"title":"Knowledge Base","href":"/knowledge-base/introduction"}]},{"tab":"Self-Hosting","icon":"server","pages":[{"title":"Self-Hosting","href":"/self-hosting/overview"}]}]},"basePath":"","title":"Attach media from URL - TryPost Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}