{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Posta API | Documentation","colors":{"primary":"#F45D0B","light":"#F45D0B","dark":"#F45D0B"},"logo":{"light":"https://mintcdn.com/veezla-800e2fc2/UlA7jHgoq68Vl42_/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=UlA7jHgoq68Vl42_\u0026q=85\u0026s=03b05bf87b88d66edab2b10a66a5f8df","dark":"https://mintcdn.com/veezla-800e2fc2/UlA7jHgoq68Vl42_/assets/logo/dark.svg?fit=max\u0026auto=format\u0026n=UlA7jHgoq68Vl42_\u0026q=85\u0026s=28742105bf3fdfadc0f31be5adcd6f01","href":"https://posta.co"},"favicon":"https://mintcdn.com/veezla-800e2fc2/UlA7jHgoq68Vl42_/assets/favicon.svg?fit=max\u0026auto=format\u0026n=UlA7jHgoq68Vl42_\u0026q=85\u0026s=f39d311bcbed9aa6efbe16df3f710c4a","api":{"openapi":["openapi.2024-07-30.json"],"examples":{"defaults":"required","languages":["bash","python","javascript"],"prefill":true},"mdx":{"auth":{"method":"key","name":"my-api-key"}}},"background":{"decoration":"gradient","color":{"dark":"#0A0A0A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.posta.co"}},"footer":{"socials":{"github":"https://github.com/veezla","linkedin":"https://www.linkedin.com/company/veezla"},"links":[{"header":"Resources","items":[{"label":"System status","href":"https://status.posta.co"},{"label":"Trust center","href":"https://trust.veezla.com"}]}]},"seo":{"metatags":{"og:site_name":"Posta API Documentation","twitter:card":"summary"},"indexing":"navigable"},"icons":{"library":"lucide"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"veezla-800e2fc2","hasAudioNarration":false,"actualSubdomain":"veezla-800e2fc2","customDomains":["docs.posta.co"],"gitSource":{"type":"github","owner":"veezla","repo":"posta-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"REMOVE_BRANDING":{"status":"ENABLED"}},"buildId":"6ae921372e86bd0c182fb407:success","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"API Reference","count":33},{"language":"default","tag":"Assets","count":27},{"language":"default","tag":"Asset Versions","count":10},{"language":"default","tag":"Getting started","count":8},{"language":"default","tag":"Working with our API","count":7},{"language":"default","tag":"Postal","count":6},{"language":"default","tag":"Letters","count":6},{"language":"default","tag":"Guides","count":3},{"language":"default","tag":"Changelog","count":2}]},"assistantConfig":{},"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":[],"page":{"pagePath":"api-reference/assets/asset-versions/list-asset-versions","slug":"/api-reference/assets/asset-versions/list-asset-versions","pageMetadata":{"openapi":"GET /assets/{id}/versions","title":"List asset versions","description":"Retrieve a paginated list of versions for a specific asset.","href":"/api-reference/assets/asset-versions/list-asset-versions"},"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: \"Retrieve a paginated list of versions for a specific asset.\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Results are ordered from newest to oldest.`})}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":{"openapi":"GET /assets/{id}/versions","title":"List asset versions","description":"Retrieve a paginated list of versions for a specific asset.","href":"/api-reference/assets/asset-versions/list-asset-versions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/veezla-800e2fc2/8c683dacd7b794a8/scripts/generate-schemas.js"],"openApiReferenceData":{"operation":{"operationId":"listAssetVersions","summary":"List asset versions","description":"Retrieve a paginated list of versions for a specific asset.","parameters":["f6765b0e-dc9b-4907-961c-afdffec68457","1e2d99c4-1658-460e-84f1-570bd2c3b55b","2a38e7b8-7324-422e-b228-b99ab1eab884","55f06fa1-27c9-4d33-b640-bc0f43860646"],"responses":{"200":"f0ebe3ab-999a-4724-8b1e-5c657eab73f4","401":"01c3c251-ffaa-495b-b731-5f3054509dce","403":"f11978e9-4a5d-42a5-ae45-9dfb4622a724","429":"a2f5bede-46e9-40e8-8acd-02b003955135","500":"18a1fa9c-d25f-4c0e-9fce-3c10991b71eb"},"tags":["Asset Versions"],"security":["b50f6fc0-f56a-434b-8a80-0f420ce0638d"],"method":"get","type":"path","servers":["06d8291e-752e-492c-8741-383d25a97cf6"],"path":"/assets/{id}/versions","baseUrlOptions":["https://api.posta.co"],"title":"List asset versions","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"f6765b0e-dc9b-4907-961c-afdffec68457":{"name":"id","in":"path","required":true,"description":"The unique identifier of the asset. Format: 'ast_' followed by alphanumeric characters.","schema":{"type":"string","isRequired":true,"description":"The unique identifier of the asset. Format: 'ast_' followed by alphanumeric characters.","uniqueKey":"","typeLabel":"string"}},"1e2d99c4-1658-460e-84f1-570bd2c3b55b":{"name":"includeArchived","in":"query","required":false,"description":"Include archived versions in the results. Default is `false`.","schema":{"type":"boolean","isRequired":false,"description":"Include archived versions in the results. Default is `false`.","uniqueKey":"","typeLabel":"boolean"},"explode":false},"2a38e7b8-7324-422e-b228-b99ab1eab884":{"name":"pageSize","in":"query","required":false,"description":"The number of items to return per page. The maximum `pageSize` is 100 items.","schema":{"type":"integer","isRequired":false,"description":"The number of items to return per page. The maximum `pageSize` is 100 items.","uniqueKey":"","typeLabel":"integer"},"explode":false},"55f06fa1-27c9-4d33-b640-bc0f43860646":{"name":"nextToken","in":"query","required":false,"description":"A cursor for the next page of results.","schema":{"type":"string","isRequired":false,"description":"A cursor for the next page of results.","uniqueKey":"","typeLabel":"string"},"explode":false}},"responses":{"f0ebe3ab-999a-4724-8b1e-5c657eab73f4":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","status","contentType","contentLength","contentUrl","createdAt","modifiedAt"],"properties":{"id":{"type":"string","example":"astv_2jyk1xYhW4n0vVfHirU5eJeXsbw","minLength":1,"maxLength":99999,"description":"Unique identifier for the Asset Version. Format: 'astv_' followed by alphanumeric characters.","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Represents the status of an Asset Version.\n\n- **`draft`**: An Asset Version that is being worked on and can be modified. This is the initial state for new Asset Version and cloned Asset Versions.\n\n- **`published`**: An Asset Version that is finalized and available for use. Published Asset Versions cannot be edited.\n\n- **`archived`**: An Asset Version unavailable for new uses but may still be accessible for historical purposes. It can be republished if needed.\n\n- **`deleted`**: An Asset Version that has been deleted from the system. This is a terminal state.\n\nState transitions:\n- Draft Asset Versions can be published, archived, or deleted.\n- Published Asset Versions can only be archived or deleted.\n- Archived Asset Versions can be republished (becoming published) or deleted.\n- Deleted is a terminal state with no further transitions.\n\nNotes:\n- Only one Asset Version can be in the published state at a time for a given Asset.\n- Publishing a new Asset Versions will automatically archive the previously published one, if there was one.\n- Cloning any non-deleted Asset Versions will create a new one in draft state.\n- Deletion is permanent and should be used with caution.","enum":["draft","published","archived","deleted"],"example":"draft","isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"contentType":{"type":"string","example":"text/html","minLength":1,"maxLength":99999,"description":"MIME type of the Asset Version content. Indicates the format of the content (e.g., 'text/html', 'image/jpeg', 'application/pdf').","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].contentType","typeLabel":"string"},"contentLength":{"type":"integer","format":"int32","example":100,"minimum":-1,"maximum":999999999,"description":"Length of the Asset Version content in bytes. Useful for content management and transfer considerations.","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].contentLength","typeLabel":"integer\u003cint32>"},"contentUrl":{"type":"string","example":"https://api.posta.co/assets/astv_2jyk1xYhW4n0vVfHirU5eJeXsbw/content","minLength":1,"maxLength":99999,"format":"uri","description":"URL where the rendered content of this asset version can be accessed. Available after publishing.","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].contentUrl","typeLabel":"string\u003curi>"},"createdAt":{"type":"string","format":"date-time","description":"The timestamp the resource was created at (UTC).","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"modifiedAt":{"type":"string","format":"date-time","description":"The timestamp the resource was last modified at (UTC).","readOnly":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].modifiedAt","typeLabel":"string\u003cdate-time>"},"notes":{"type":"string","example":"Initial version.","minLength":0,"maxLength":255,"description":"Optional notes or comments about this specific Asset Version. Useful for tracking changes or providing context.","uniqueKey":"\\items.items.[INDEX].notes","typeLabel":"string"},"variableDefinitions":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"firstName","minLength":1,"maxLength":64,"description":"Name of the Variable. Used as the key for content personalization.\nMust be unique within the Asset Version.\nExample: `firstName`","isRequired":true,"uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","description":"Specifies the type of the Variable:\n- `value`: A string value (default Variable type when not specified)\n- `asset`: References another Asset by its Id\n- `externalUrl`: References content at an external URL (must be publicly available)\n\nNote: We recommend using `asset` type Variables instead of `externalUrl` for better consistency,\nsecurity, compliance, and availability. External URLs might change without version control,\nmay be subject to throttling, or could become unavailable.","default":"value","enum":["value","asset","externalUrl"],"example":"value","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"behavior":{"type":"string","description":"Specifies how the Variable should be handled during rendering.\n- `optional`: The Variable is optional and may or may not be provided in a request (such as create letter). If `allowEmpty` is `true` you can pass an empty string as its value.\n- `required`: The Variable must be provided in a request (such as create letter). If `allowEmpty` is `true` you can pass an empty string as its value.\n- `preset`: The preset value will be used and the variable should not be included in the request (such as create letter). The `presetValue` must be defined when this behavior is used. `allowEmpty` is not applicable to this behavior.\n- `overridablePreset`: The preset value will be used, unless a value is explicitly passed in a request to override the preset value. The `presetValue` must be set when this behavior is used, and the variable can be included in a request if an override is necessary, otherwise the `presetValue` will be used. If `allowEmpty` is `true` you can pass an empty string as its value.\n\n**Note**: When using Assets with Variables with our Letter API, always review the `variableHandling` option on the Letter. If `validationScope` is set to `none` in the request, the defined variables and their behavior will not be evaluated at all. See further information on the Letter object.\n\nFor detailed examples and edge cases on how `behavior`, `allowEmpty`, and `presetValue`\ninteract, see the Assets Overview in our API reference.","default":"optional","enum":["optional","required","preset","overridablePreset"],"example":"optional","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].behavior","typeLabel":"enum\u003cstring>"},"allowEmpty":{"type":"boolean","example":true,"description":"Determines whether an empty value is acceptable for this Variable.\n\nExample empty string: `{ \"name\": \"firstName\", \"value\": \"\" }`\n\nNote: `null` is considered as no value, not an empty one.\n\nFor detailed examples and edge cases on how `behavior`, `allowEmpty`, and `presetValue`\ninteract, see the Assets Overview in our API reference.","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].allowEmpty","typeLabel":"boolean"},"presetValue":{"type":"string","example":"ast_2k1UXnFem92yBFKxtTkQQYhVWyr","minLength":0,"maxLength":512,"description":"Specifies a preset value for the Variable. This value may be used when:\n- the Variable is not provided\n- a value is provided but the behavior is set to `presetValue`\n\nFor detailed examples and edge cases on how `behavior`, `allowEmpty`, and `presetValue`\ninteract, see the Assets Overview in our API reference.\n\nExample: `\"ast_2k1UXnFem92yBFKxtTkQQYhVWyr\"`","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].presetValue","typeLabel":"string"},"exampleValue":{"type":"string","example":"Jane","minLength":0,"maxLength":512,"description":"Provides a sample value for the Variable, useful for documentation and UI purposes.\nThis value is not used in the actual rendering process. It's primarily for demonstrating\nexpected input in user interfaces or documentation.\n\nExample: `\"Jane\"`","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX].exampleValue","typeLabel":"string"}},"example":{"name":"firstName","type":"value","behavior":"required","allowEmpty":false,"exampleValue":"John"},"description":"List of variables defined for this Asset Version. Used for content personalization in HTML templates.\nA maximum of 128 variable definitions can be specified per Asset Version.\nThis limit helps maintain performance and readability of templates.","uniqueKey":"\\items.items.[INDEX].variableDefinitions.items.[INDEX]","typeLabel":"object"},"maxItems":128,"description":"List of variables defined for this Asset Version. Used for content personalization in HTML templates.\n**Note**: When using Assets with Variables with our Letter API, always review the `variableHandling` option on the Letter. If `validationScope` is set to `none` in the request, the defined variables and their behavior will not be evaluated at all. See further information on the Letter object.","uniqueKey":"\\items.items.[INDEX].variableDefinitions","typeLabel":"object[]"}},"example":{"id":"astv_2jyk1xYhW4n0vVfHirU5eJeXsbw","status":"draft","notes":"Minor changes to the footer.","content":{"source":"inline","type":"text/html","content":"\u003chtml>\u003cbody>Hello {{firstName}}\u003c/body>\u003c/html>"},"variableDefinitions":[{"name":"name","behavior":"required","allowEmpty":false}],"contentType":"text/html","contentLength":100,"contentUrl":"https://api.posta.co/assets/astv_2jyk1xYhW4n0vVfHirU5eJeXsbw/content","publish":false,"createdAt":"2023-06-07T12:34:56Z","modifiedAt":"2023-06-07T12:34:56Z"},"description":"Represents a specific version of an Asset, containing the actual content and metadata. Asset Versions are the core entities for version control, compliance tracking, and content management in Posta.\n\nKey aspects:\n- Content: Can be HTML templates (with variable support), images, fonts, or documents (e.g., PDFs).\n- Status: Determines the overall status of the parent Asset (`draft`, `published`, `archived`, or `deleted`).\n- Version Control: Allows tracking changes and maintaining multiple iterations of an Asset.\n- Compliance: Facilitates auditing and regulatory compliance through versioning.\n\nHTML templates can use variables for dynamic content. Images and fonts can be referenced as variables within HTML templates. Documents (like PDFs) are static and used for rendering documents without dynamic components.","uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"Array of items for the current page.","isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"nextToken":{"type":"string","description":"A cursor for the next page of results.","uniqueKey":"nextToken","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"items":[{"id":"astv_2jyk1xYhW4n0vVfHirU5eJeXsbw","status":"draft","notes":"Minor changes to the footer.","content":{"source":"inline","type":"text/html","content":"\u003chtml>\u003cbody>Hello {{firstName}}\u003c/body>\u003c/html>"},"variableDefinitions":[{"name":"name","behavior":"required","allowEmpty":false}],"contentType":"text/html","contentLength":100,"contentUrl":"https://api.posta.co/assets/astv_2jyk1xYhW4n0vVfHirU5eJeXsbw/content","publish":false,"createdAt":"2023-06-07T12:34:56Z","modifiedAt":"2023-06-07T12:34:56Z"}],"nextToken":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"01c3c251-ffaa-495b-b731-5f3054509dce":{"description":"Access is unauthorized.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"f11978e9-4a5d-42a5-ae45-9dfb4622a724":{"description":"Access is forbidden.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a2f5bede-46e9-40e8-8acd-02b003955135":{"description":"Client error","headers":{"P-RateLimit-Limit":{"required":false,"schema":{"type":"integer"}},"P-RateLimit-Remaining":{"required":false,"schema":{"type":"integer"}},"P-RateLimit-Reset":{"required":false,"schema":{"type":"string","format":"date-time"}}},"content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"18a1fa9c-d25f-4c0e-9fce-3c10991b71eb":{"description":"Server error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"b50f6fc0-f56a-434b-8a80-0f420ce0638d":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":[]}}},"servers":{"06d8291e-752e-492c-8741-383d25a97cf6":{"url":"https://api.posta.co","description":"Posta API endpoint","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-Api-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.2024-07-30.json"},"subdomain":"veezla-800e2fc2","siteName":"Posta API | Documentation","title":"List asset versions - Posta API | Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-12-23T05:31:04.867Z","gitLastModified":"2024-08-09T06:24:37.000Z","originalFileLocation":"api-reference/assets/asset-versions/list-asset-versions.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=\"Retrieve a paginated list of versions for a specific asset.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Posta API | Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_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/veezla-800e2fc2/7rwsZlVOfmH242K4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List asset versions - Posta API | Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a paginated list of versions for a specific asset.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Posta API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://veezla-800e2fc2.mintlify.site/_mintlify/api/og/v2?division=Asset+Versions\u0026amp;title=List+asset+versions\u0026amp;description=Retrieve+a+paginated+list+of+versions+for+a+specific+asset.\u0026amp;theme=0b3c2a7be5c1c1f30e92d0a1\u0026amp;signature=8ce09f50c7449bb535b3f17d831fa5925fe67be346d00b2af4fa18772f77d3d1\">\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 asset versions - Posta API | Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a paginated list of versions for a specific asset.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veezla-800e2fc2.mintlify.site/_mintlify/api/og/v2?division=Asset+Versions\u0026amp;title=List+asset+versions\u0026amp;description=Retrieve+a+paginated+list+of+versions+for+a+specific+asset.\u0026amp;theme=0b3c2a7be5c1c1f30e92d0a1\u0026amp;signature=8ce09f50c7449bb535b3f17d831fa5925fe67be346d00b2af4fa18772f77d3d1\">\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/veezla-800e2fc2/7rwsZlVOfmH242K4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Posta API | Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F45D0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/assets/asset-versions/list-asset-versions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.posta.co/#organization\",\"name\":\"Posta API | Documentation\",\"url\":\"https://docs.posta.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/veezla-800e2fc2/UlA7jHgoq68Vl42_/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=UlA7jHgoq68Vl42_\u0026q=85\u0026s=03b05bf87b88d66edab2b10a66a5f8df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.posta.co#website\",\"name\":\"Posta API | Documentation\",\"url\":\"https://docs.posta.co\",\"publisher\":{\"@id\":\"https://docs.posta.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions#webpage\",\"url\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions\",\"name\":\"List asset versions\",\"description\":\"Retrieve a paginated list of versions for a specific asset.\",\"dateModified\":\"2024-08-09T06:24:37.000Z\",\"isPartOf\":{\"@id\":\"https://docs.posta.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Assets\",\"item\":\"https://docs.posta.co/api-reference/assets/assets-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Asset Versions\",\"item\":\"https://docs.posta.co/api-reference/assets/asset-versions/asset-version-schema\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List asset versions\",\"item\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions#apireference\",\"headline\":\"List asset versions\",\"name\":\"List asset versions\",\"description\":\"Retrieve a paginated list of versions for a specific asset.\",\"url\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.posta.co/api-reference/assets/asset-versions/list-asset-versions#webpage\"},\"dateModified\":\"2024-08-09T06:24:37.000Z\",\"publisher\":{\"@id\":\"https://docs.posta.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.posta.co#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/assets/asset-versions/list-asset-versions.md","siteName":"Posta API | Documentation","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/welcome"}]},{"tab":"API Reference","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"group":"Working with our API","pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Versioning","sidebarTitle":"Versioning","href":"/api-reference/versioning"},{"title":"Pagination","sidebarTitle":"Pagination","href":"/api-reference/pagination"},{"title":"Idempotency","sidebarTitle":"Idempotency","href":"/api-reference/idempotency"},{"title":"Rate limiting","sidebarTitle":"Rate limiting","href":"/api-reference/rate-limiting"},{"title":"Metadata","sidebarTitle":"Metadata","href":"/api-reference/metadata"},{"title":"Errors","sidebarTitle":"Errors","href":"/api-reference/errors"}]}]},{"group":"Assets","icon":"library","pages":[{"title":"Overview","href":"/api-reference/assets/assets-overview"},{"group":"Assets","pages":[{"title":"Asset object","sidebarTitle":"Asset object","href":"/api-reference/assets/assets/asset-schema"},{"openapi":"GET /assets","title":"List assets","href":"/api-reference/assets/assets/list-assets"},{"openapi":"POST /assets","title":"Create asset","href":"/api-reference/assets/assets/create-asset"},{"openapi":"GET /assets/{id}","title":"Get asset","href":"/api-reference/assets/assets/get-asset"},{"openapi":"PUT /assets/{id}","title":"Update asset","href":"/api-reference/assets/assets/update-asset"},{"openapi":"POST /assets/{id}/clone","title":"Clone asset","href":"/api-reference/assets/assets/clone-asset"},{"openapi":"POST /assets/{id}/archive","title":"Archive asset","href":"/api-reference/assets/assets/archive-asset"},{"openapi":"DELETE /assets/{id}","title":"Delete asset","href":"/api-reference/assets/assets/delete-asset"}]},{"group":"Asset Versions","pages":[{"title":"Asset Version object","sidebarTitle":"Asset Version object","description":null,"href":"/api-reference/assets/asset-versions/asset-version-schema"},{"openapi":"GET /assets/{id}/versions","title":"List asset versions","href":"/api-reference/assets/asset-versions/list-asset-versions"},{"openapi":"POST /assets/{id}/versions","title":"Create asset version","description":"Create a new asset version for an existing asset.","href":"/api-reference/assets/asset-versions/create-asset-version"},{"openapi":"GET /assets/{id}/versions/{versionId}","title":"Get asset version","href":"/api-reference/assets/asset-versions/get-asset-version"},{"openapi":"PUT /assets/{id}/versions/{versionId}","title":"Update asset version","href":"/api-reference/assets/asset-versions/update-asset-version"},{"openapi":"POST /assets/{id}/versions/{versionId}/publish","title":"Publish asset version","href":"/api-reference/assets/asset-versions/publish-asset-version"},{"openapi":"GET /assets/{id}/versions/{versionId}/download","title":"Download asset version","href":"/api-reference/assets/asset-versions/download-asset-version"},{"openapi":"POST /assets/{id}/versions/{versionId}/clone","title":"Clone asset version","href":"/api-reference/assets/asset-versions/clone-asset-version"},{"openapi":"POST /assets/{id}/versions/{versionId}/archive","title":"Archive asset version","href":"/api-reference/assets/asset-versions/archive-asset-version"},{"openapi":"DELETE /assets/{id}/versions/{versionId}","title":"Delete asset version","href":"/api-reference/assets/asset-versions/delete-asset-version"}]}]},{"group":"Postal","icon":"mail","pages":[{"group":"Letters","pages":[{"title":"Letter object","href":"/api-reference/postal/letters/letter-schema"},{"openapi":"GET /letters","title":"List letters","href":"/api-reference/postal/letters/list-letters"},{"openapi":"POST /letters","title":"Create letter","href":"/api-reference/postal/letters/create-letter"},{"openapi":"GET /letters/{id}","title":"Get letter","href":"/api-reference/postal/letters/retrieve-letter"},{"openapi":"POST /letters/{id}/cancel","title":"Cancel letter","href":"/api-reference/postal/letters/cancel-letter"},{"openapi":"GET /letters/{id}/download","title":"Download letter PDF","href":"/api-reference/postal/letters/download-letter"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"List asset versions - Posta API | Documentation","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DSpdRuhM.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}