{
"error": {
"code": "unauthorized",
"message": "A valid Nylon API key is required."
}
}
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry after the window resets."
}
}
{
"error": {
"code": "unauthorized",
"message": "A valid Nylon API key is required.",
"details": [
{
"message": "Instagram requires at least 1 media item — text-only posts are not supported.",
"field": "profile_ids",
"network": "instagram",
"code": "invalid_request"
}
]
}
}
Authorizations
Authorization
string
header
required
An API key beginning with nylon_live_.
Query Parameters
limit
integer
default:25
Page size, 1–100.
Required range: 1 <= x <= 100
offset
integer
default:0
Rows to skip.
Required range: x >= 0
Response
The hosted files.
data
object[]
required
Hide child attributes
data.url
string<uri>
required
The handle. Pass this to POST /v1/posts — there is no media id in the API.
data.type
enum<string>
required
Available options:
image,
video,
gif
data.content_type
string
required
Example:
"image/jpeg"
data.size_bytes
integer
required
Example:
482113
data.status
enum<string>
required
temporary until a post using it publishes; then kept indefinitely.
{
"error": {
"code": "unauthorized",
"message": "A valid Nylon API key is required."
}
}
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry after the window resets."
}
}
{
"error": {
"code": "unauthorized",
"message": "A valid Nylon API key is required.",
"details": [
{
"message": "Instagram requires at least 1 media item — text-only posts are not supported.",
"field": "profile_ids",
"network": "instagram",
"code": "invalid_request"
}
]
}
}
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Nylon API Docs","colors":{"primary":"#357adf","light":"#359bdf","dark":"#357adf"},"logo":{"light":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=1eb1edf70a217092111a28527249906b","dark":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo-dark.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=61bb5cbe6da73c3a5edaaf4d26314b54","href":"https://app.nylon.dev/"},"favicon":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/favicon.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=6129a297664c479adc04e86d342d60bf","api":{"openapi":{"source":"openapi.yaml","directory":"api-reference"},"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","python","php","ruby"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"links":[{"href":"https://app.nylon.dev/connections","label":"Connections"},{"href":"https://app.nylon.dev/api","label":"API keys"}]},"icons":{"library":"lucide"},"contextual":{"options":["chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nylon","hasAudioNarration":false,"actualSubdomain":"nylon","customDomains":["docs.nylon.dev"],"gitSource":{"type":"github","owner":"ocoya","repo":"ocoya","deployBranch":"main","contentDirectory":"apps/nylon-web/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac41b48ccd3b85aecd8c4bc","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Help center","count":33},{"language":"default","tag":"API reference","count":32},{"language":"default","tag":"Endpoints","count":31},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"Connections","count":12},{"language":"default","tag":"Webhooks","count":11},{"language":"default","tag":"Get started","count":10},{"language":"default","tag":"Posts","count":7},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Inbox","count":5}]},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--nylon-publishing: #357adf;--nylon-publishing-soft: #eaf2fc;--nylon-inbox: #059669;--nylon-inbox-soft: #e7f6f0;--nylon-analytics: #ea580c;--nylon-analytics-soft: #fdefe6;--nylon-border: #e5e5e5;--nylon-muted: #737373}.dark{--nylon-publishing-soft: rgba(53, 122, 223, 0.14);--nylon-inbox-soft: rgba(5, 150, 105, 0.14);--nylon-analytics-soft: rgba(234, 88, 12, 0.14);--nylon-border: #262626;--nylon-muted: #a3a3a3}[data-pillar=\"publishing\"]{--pillar: var(--nylon-publishing);--pillar-soft: var(--nylon-publishing-soft)}[data-pillar=\"inbox\"]{--pillar: var(--nylon-inbox);--pillar-soft: var(--nylon-inbox-soft)}[data-pillar=\"analytics\"]{--pillar: var(--nylon-analytics);--pillar-soft: var(--nylon-analytics-soft)}.pillar-hero{display:flex;gap:1rem;align-items:flex-start;padding:1.25rem;margin:0 0 1.75rem;border:1px solid var(--nylon-border);border-left:3px solid var(--pillar);border-radius:12px;background:linear-gradient(90deg, var(--pillar-soft), transparent 70%)}.pillar-hero__mark{display:grid;place-items:center;flex:0 0 auto;width:2.25rem;height:2.25rem;border-radius:9px;background:var(--pillar-soft);color:var(--pillar)}.pillar-hero__mark svg{width:1.125rem;height:1.125rem}.pillar-hero__body{min-width:0}.pillar-hero__eyebrow{display:block;margin:0 0 0.15rem;font-size:0.75rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:var(--pillar)}.pillar-hero__body p{margin:0;color:var(--nylon-muted);font-size:0.9375rem;line-height:1.55}.pillar-status{display:inline-flex;align-items:center;gap:0.4rem;margin-top:0.6rem;padding:0.15rem 0.55rem;border-radius:999px;font-size:0.75rem;font-weight:500;border:1px solid currentColor}.pillar-status::before{content:'';width:0.4rem;height:0.4rem;border-radius:999px;background:currentColor}.pillar-status--live{color:#047857}.pillar-status--partial{color:#047857}.pillar-status--soon{color:#b45309}#sidebar a[href^=\"/publishing\"] svg,#sidebar a[href*=\"/publishing\"] svg{color:var(--nylon-publishing)}#sidebar a[href^=\"/inbox\"] svg,#sidebar a[href*=\"/inbox\"] svg{color:var(--nylon-inbox)}#sidebar a[href^=\"/analytics\"] svg,#sidebar a[href*=\"/analytics\"] svg{color:var(--nylon-analytics)}#navbar a[href=\"https://app.nylon.dev/\"] img,[data-component-part=\"navbar-logo\"] img{height:18px!important;max-height:18px!important;width:auto!important;max-width:132px!important;object-fit:contain}#navbar a[href=\"https://app.nylon.dev/connections\"],#navbar a[href=\"https://app.nylon.dev/api\"],[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"],[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]{color:#52525b;font-weight:500;text-decoration:none}#navbar a[href=\"https://app.nylon.dev/connections\"]:hover,#navbar a[href=\"https://app.nylon.dev/connections\"]:focus,#navbar a[href=\"https://app.nylon.dev/api\"]:hover,#navbar a[href=\"https://app.nylon.dev/api\"]:focus,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"]:hover,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"]:focus,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]:hover,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]:focus{color:#27272a}"}],"page":{"pagePath":"api-reference/list-media","slug":"/api-reference/list-media","pageMetadata":{"title":"List hosted media","description":"Everything Nylon is storing for you, and when it expires.","deprecated":null,"version":null,"sidebarTitle":"List media","openapi":"/openapi.yaml get /v1/media","href":"/api-reference/list-media","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Everything Nylon is storing for you, and when it expires.\"\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":"List hosted media","description":"Everything Nylon is storing for you, and when it expires.","deprecated":null,"version":null,"sidebarTitle":"List media","openapi":"/openapi.yaml get /v1/media","href":"/api-reference/list-media","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Media"],"operationId":"listMedia","summary":"List hosted media","description":"Everything Nylon is storing for you, and when it expires.","x-mint":{"href":"/api-reference/list-media","metadata":{"title":"List hosted media","description":"Everything Nylon is storing for you, and when it expires."}},"parameters":["f183e7ad-ab55-49a2-974f-043b78ed4993","5cec51e3-a7dc-4ca5-991c-1490b2ac0abd"],"responses":{"200":"99820d92-28fc-42d4-8111-b8a24b2d14b2","401":"de249233-bbcf-421c-8e7f-125ae1bfbc96","429":"42a1486f-f6be-48b4-90f4-e8434cca9896","500":"c8072c9d-c9e7-41a0-942e-387248b77d58"},"method":"get","type":"path","servers":["7e3142f8-7813-4409-b324-6875bf414bdf"],"security":["4a364daf-05fe-4010-8757-60e84043d0f6"],"path":"/v1/media","baseUrlOptions":["https://api.nylon.dev"],"title":"List hosted media","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php","ruby"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"f183e7ad-ab55-49a2-974f-043b78ed4993":{"name":"limit","in":"query","description":"Page size, 1–100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Page size, 1–100.","uniqueKey":"","typeLabel":"integer"}},"5cec51e3-a7dc-4ca5-991c-1490b2ac0abd":{"name":"offset","in":"query","description":"Rows to skip.","schema":{"type":"integer","minimum":0,"default":0,"description":"Rows to skip.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"99820d92-28fc-42d4-8111-b8a24b2d14b2":{"description":"The hosted files.","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["url","type","content_type","size_bytes","status"],"properties":{"url":{"type":"string","format":"uri","description":"The handle. Pass this to `POST /v1/posts` — there is no media id in the API.","isRequired":true,"uniqueKey":"data.items.[INDEX].url","typeLabel":"string\u003curi>"},"type":{"type":"string","enum":["image","video","gif"],"isRequired":true,"uniqueKey":"data.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"content_type":{"type":"string","example":"image/jpeg","isRequired":true,"uniqueKey":"data.items.[INDEX].content_type","typeLabel":"string"},"size_bytes":{"type":"integer","example":482113,"isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes","typeLabel":"integer"},"status":{"type":"string","enum":["temporary","permanent"],"description":"`temporary` until a post using it publishes; then kept indefinitely.","isRequired":true,"uniqueKey":"data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.items.[INDEX].expires_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"meta":{"type":"object","properties":{"pagination":{"type":"object","required":["limit","offset","total","has_more"],"properties":{"limit":{"type":"integer","example":25,"isRequired":true,"uniqueKey":"meta.pagination.limit","typeLabel":"integer"},"offset":{"type":"integer","example":0,"isRequired":true,"uniqueKey":"meta.pagination.offset","typeLabel":"integer"},"total":{"type":"integer","example":132,"isRequired":true,"uniqueKey":"meta.pagination.total","typeLabel":"integer"},"has_more":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"meta.pagination.has_more","typeLabel":"boolean"}},"uniqueKey":"meta.pagination","typeLabel":"object"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"url":"\u003cstring>","type":"image","content_type":"image/jpeg","size_bytes":482113,"status":"temporary","expires_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z"}],"meta":{"pagination":{"limit":25,"offset":0,"total":132,"has_more":true}}}}},"exampleType":"generated"}},"exampleType":"generated"},"de249233-bbcf-421c-8e7f-125ae1bfbc96":{"description":"The bearer API key is missing, malformed or revoked.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"The stable identifier to branch on.","enum":["invalid_request","unauthorized","payment_required","forbidden","not_found","conflict","rate_limited","unsupported","publish_failed","internal_error"],"example":"unauthorized","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Written for humans. Do not match on it.","example":"A valid Nylon API key is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Present when the failure has a per-field or per-network breakdown.","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","example":"Instagram requires at least 1 media item — text-only posts are not supported.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"The request field the problem is about.","example":"profile_ids","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"network":{"type":"string","description":"The network the problem is about.","example":"instagram","uniqueKey":"error.details.items.[INDEX].network","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable identifier for this problem. On a per-network\ndetail this is a publishing code: `invalid_request`,\n`unsupported`, `media_error`, `reauthentication_required`,\n`rejected_by_network`, `network_error`, `timeout`,\n`profile_unavailable` or `internal_error`.\n","example":"invalid_request","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingKey":{"title":"missingKey","value":{"error":{"code":"unauthorized","message":"A valid Nylon API key is required."}}}},"exampleType":"examples"}},"exampleType":"examples"},"42a1486f-f6be-48b4-90f4-e8434cca9896":{"description":"Too many requests for this API key. Reads allow 120 requests a minute;\npublishing endpoints allow 30, because each one costs real upstream\ncalls. The limit is per key, not per IP.\n","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":47}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer","example":120}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer","example":119}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer","example":47}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"The stable identifier to branch on.","enum":["invalid_request","unauthorized","payment_required","forbidden","not_found","conflict","rate_limited","unsupported","publish_failed","internal_error"],"example":"unauthorized","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Written for humans. Do not match on it.","example":"A valid Nylon API key is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Present when the failure has a per-field or per-network breakdown.","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","example":"Instagram requires at least 1 media item — text-only posts are not supported.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"The request field the problem is about.","example":"profile_ids","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"network":{"type":"string","description":"The network the problem is about.","example":"instagram","uniqueKey":"error.details.items.[INDEX].network","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable identifier for this problem. On a per-network\ndetail this is a publishing code: `invalid_request`,\n`unsupported`, `media_error`, `reauthentication_required`,\n`rejected_by_network`, `network_error`, `timeout`,\n`profile_unavailable` or `internal_error`.\n","example":"invalid_request","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"throttled":{"title":"throttled","value":{"error":{"code":"rate_limited","message":"Too many requests. Retry after the window resets."}}}},"exampleType":"examples"}},"exampleType":"examples"},"c8072c9d-c9e7-41a0-942e-387248b77d58":{"description":"Nylon encountered an unexpected error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"The stable identifier to branch on.","enum":["invalid_request","unauthorized","payment_required","forbidden","not_found","conflict","rate_limited","unsupported","publish_failed","internal_error"],"example":"unauthorized","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Written for humans. Do not match on it.","example":"A valid Nylon API key is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Present when the failure has a per-field or per-network breakdown.","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","example":"Instagram requires at least 1 media item — text-only posts are not supported.","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"The request field the problem is about.","example":"profile_ids","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"network":{"type":"string","description":"The network the problem is about.","example":"instagram","uniqueKey":"error.details.items.[INDEX].network","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable identifier for this problem. On a per-network\ndetail this is a publishing code: `invalid_request`,\n`unsupported`, `media_error`, `reauthentication_required`,\n`rejected_by_network`, `network_error`, `timeout`,\n`profile_unavailable` or `internal_error`.\n","example":"invalid_request","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"A valid Nylon API key is required.","details":[{"message":"Instagram requires at least 1 media item — text-only posts are not supported.","field":"profile_ids","network":"instagram","code":"invalid_request"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4a364daf-05fe-4010-8757-60e84043d0f6":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Nylon API key","description":"An API key beginning with `nylon_live_`.","scopes":[]}}},"servers":{"7e3142f8-7813-4409-b324-6875bf414bdf":{"url":"https://api.nylon.dev","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Nylon API key","description":"An API key beginning with `nylon_live_`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key beginning with `nylon_live_`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"nylon","siteName":"Nylon API Docs","title":"List hosted media - Nylon API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T22:05:51.955Z","originalFileLocation":"api-reference/list-media.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Everything Nylon is storing for you, and when it expires.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nylon API 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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List hosted media - Nylon API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Everything Nylon is storing for you, and when it expires.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nylon API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nylon.dev/api-reference/list-media\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nylon.mintlify.site/_mintlify/api/og/v2?division=Media\u0026amp;title=List+hosted+media\u0026amp;description=Everything+Nylon+is+storing+for+you%2C+and+when+it+expires.\u0026amp;theme=b05593bd5939955c58560eb1\u0026amp;signature=ef34c6328d490e1779e7a93dc89929a7aa7024a3ad37f62a0ed0a6cca680287a\">\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=\"List hosted media - Nylon API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Everything Nylon is storing for you, and when it expires.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nylon.mintlify.site/_mintlify/api/og/v2?division=Media\u0026amp;title=List+hosted+media\u0026amp;description=Everything+Nylon+is+storing+for+you%2C+and+when+it+expires.\u0026amp;theme=b05593bd5939955c58560eb1\u0026amp;signature=ef34c6328d490e1779e7a93dc89929a7aa7024a3ad37f62a0ed0a6cca680287a\">\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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nylon API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#357adf\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nylon.dev/api-reference/list-media\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/list-media.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nylon.dev/#organization\",\"name\":\"Nylon API Docs\",\"url\":\"https://docs.nylon.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=1eb1edf70a217092111a28527249906b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nylon.dev#website\",\"name\":\"Nylon API Docs\",\"url\":\"https://docs.nylon.dev\",\"publisher\":{\"@id\":\"https://docs.nylon.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nylon.dev/api-reference/list-media#webpage\",\"url\":\"https://docs.nylon.dev/api-reference/list-media\",\"name\":\"List hosted media\",\"description\":\"Everything Nylon is storing for you, and when it expires.\",\"dateModified\":\"2026-09-27T22:05:51.955Z\",\"isPartOf\":{\"@id\":\"https://docs.nylon.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nylon.dev/api-reference/list-media#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nylon.dev/api-reference/list-media#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.nylon.dev/api-reference/list-posts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List hosted media\",\"item\":\"https://docs.nylon.dev/api-reference/list-media\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nylon.dev/api-reference/list-media#apireference\",\"headline\":\"List hosted media\",\"name\":\"List hosted media\",\"description\":\"Everything Nylon is storing for you, and when it expires.\",\"url\":\"https://docs.nylon.dev/api-reference/list-media\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nylon.dev/api-reference/list-media#webpage\"},\"dateModified\":\"2026-09-27T22:05:51.955Z\",\"publisher\":{\"@id\":\"https://docs.nylon.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nylon.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nylon API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nylon API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/list-media.md","siteName":"Nylon API Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"API reference","groups":[{"group":"Overview","icon":"list-tree","pages":[{"title":"API reference","icon":"list-tree","href":"/api-reference"}]},{"group":"Endpoints","icon":"code","pages":[{"group":"Posts","pages":[{"title":"List posts","deprecated":null,"version":null,"sidebarTitle":"List posts","openapi":"/openapi.yaml get /v1/posts","href":"/api-reference/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"sidebarTitle":"Create post","openapi":"/openapi.yaml post /v1/posts","href":"/api-reference/create-post"},{"title":"Retrieve a post","deprecated":null,"version":null,"sidebarTitle":"Get post","openapi":"/openapi.yaml get /v1/posts/{postId}","href":"/api-reference/get-post"},{"title":"Cancel a scheduled post","deprecated":null,"version":null,"sidebarTitle":"Cancel post","openapi":"/openapi.yaml delete /v1/posts/{postId}","href":"/api-reference/cancel-post"},{"title":"Update a scheduled post","deprecated":null,"version":null,"sidebarTitle":"Update post","openapi":"/openapi.yaml patch /v1/posts/{postId}","href":"/api-reference/update-post"},{"title":"Retry failed targets","deprecated":null,"version":null,"sidebarTitle":"Retry post","openapi":"/openapi.yaml post /v1/posts/{postId}/retry","href":"/api-reference/retry-post"},{"title":"Validate a post","deprecated":null,"version":null,"sidebarTitle":"Validate post","openapi":"/openapi.yaml post /v1/validate","href":"/api-reference/validate-post"}]},{"group":"Profiles","pages":[{"title":"List connected profiles","deprecated":null,"version":null,"sidebarTitle":"List profiles","openapi":"/openapi.yaml get /v1/profiles","href":"/api-reference/list-profiles"},{"title":"Retrieve a profile","deprecated":null,"version":null,"sidebarTitle":"Get profile","openapi":"/openapi.yaml get /v1/profiles/{profileId}","href":"/api-reference/get-profile"},{"title":"Disconnect a profile","deprecated":null,"version":null,"sidebarTitle":"Disconnect profile","openapi":"/openapi.yaml delete /v1/profiles/{profileId}","href":"/api-reference/disconnect-profile"},{"title":"List Pinterest boards","deprecated":null,"version":null,"sidebarTitle":"List profile boards","openapi":"/openapi.yaml get /v1/profiles/{profileId}/boards","href":"/api-reference/list-profile-boards"}]},{"group":"Connections","pages":[{"title":"List connectable networks","deprecated":null,"version":null,"sidebarTitle":"List connections","openapi":"/openapi.yaml get /v1/connections","href":"/api-reference/list-connections"},{"title":"Start a connection","deprecated":null,"version":null,"sidebarTitle":"Create connection","openapi":"/openapi.yaml post /v1/connections","href":"/api-reference/create-connection"},{"title":"Import a connection","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/connections/import","href":"/api-reference/connections/import-a-connection"}]},{"group":"Networks","pages":[{"title":"List network capabilities","deprecated":null,"version":null,"sidebarTitle":"List networks","openapi":"/openapi.yaml get /v1/networks","href":"/api-reference/list-networks"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"sidebarTitle":"List webhooks","openapi":"/openapi.yaml get /v1/webhooks","href":"/api-reference/list-webhooks"},{"title":"Register a webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Create webhook","openapi":"/openapi.yaml post /v1/webhooks","href":"/api-reference/create-webhook"},{"title":"Retrieve a webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Get webhook","openapi":"/openapi.yaml get /v1/webhooks/{webhookId}","href":"/api-reference/get-webhook"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete webhook","openapi":"/openapi.yaml delete /v1/webhooks/{webhookId}","href":"/api-reference/delete-webhook"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Update webhook","openapi":"/openapi.yaml patch /v1/webhooks/{webhookId}","href":"/api-reference/update-webhook"},{"title":"Rotate the signing secret","deprecated":null,"version":null,"sidebarTitle":"Rotate webhook secret","openapi":"/openapi.yaml post /v1/webhooks/{webhookId}/secret","href":"/api-reference/rotate-webhook-secret"},{"title":"Send a test event","deprecated":null,"version":null,"sidebarTitle":"Test webhook","openapi":"/openapi.yaml post /v1/webhooks/{webhookId}/test","href":"/api-reference/test-webhook"},{"title":"List deliveries","description":"The delivery log for one endpoint, with payloads and responses.","deprecated":null,"version":null,"sidebarTitle":"List webhook deliveries","openapi":"/openapi.yaml get /v1/webhooks/{webhookId}/deliveries","href":"/api-reference/list-webhook-deliveries"}]},{"group":"Media","pages":[{"title":"List hosted media","deprecated":null,"version":null,"sidebarTitle":"List media","openapi":"/openapi.yaml get /v1/media","href":"/api-reference/list-media"},{"title":"Host a file","description":"Copy a link into Nylon's storage, or post the bytes directly.","deprecated":null,"version":null,"sidebarTitle":"Create media","openapi":"/openapi.yaml post /v1/media","href":"/api-reference/create-media"},{"title":"Start a large upload","deprecated":null,"version":null,"sidebarTitle":"Create media upload","openapi":"/openapi.yaml post /v1/media/uploads","href":"/api-reference/create-media-upload"}]},{"group":"Inbox","pages":[{"title":"List conversations","deprecated":null,"version":null,"sidebarTitle":"List conversations","openapi":"/openapi.yaml get /v1/inbox/conversations","href":"/api-reference/list-conversations"},{"title":"Retrieve a conversation","deprecated":null,"version":null,"sidebarTitle":"Get conversation","openapi":"/openapi.yaml get /v1/inbox/conversations/{conversationId}","href":"/api-reference/get-conversation"},{"title":"List messages","deprecated":null,"version":null,"sidebarTitle":"List conversation messages","openapi":"/openapi.yaml get /v1/inbox/conversations/{conversationId}/messages","href":"/api-reference/list-conversation-messages"},{"title":"Reply in a conversation","deprecated":null,"version":null,"sidebarTitle":"Reply to conversation","openapi":"/openapi.yaml post /v1/inbox/conversations/{conversationId}/messages","href":"/api-reference/reply-to-conversation"},{"title":"Mark a conversation read","deprecated":null,"version":null,"sidebarTitle":"Mark conversation read","openapi":"/openapi.yaml post /v1/inbox/conversations/{conversationId}/read","href":"/api-reference/mark-conversation-read"}]}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/mcp/get-started"}]},{"tab":"Help center","pages":[{"title":"Help center","href":"/help"}]}]},"basePath":"","title":"List hosted media - Nylon API Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}