Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.
An array of content parts to render into a single PDF. Each part can be a URL string, HTML content string, or a structured content object with type and content.
Required array length: 1 - 50 elements
A content part that can be a URL string, HTML string, or a structured content object.
Emulates the specified media type during rendering. Use 'screen' for web display styles or 'print' for print-optimized styles. Particularly useful for pages with different CSS for screen and print media queries.
Evaluates a JavaScript expression in the page context before rendering. Useful for manipulating the DOM, triggering actions, or waiting for dynamic content to load. If the expression returns a Promise, rendering will wait for it to resolve.
Specifies which pages to include in the output using a comma-separated list of page ranges (e.g., '1-5, 8, 11-13'). Uses one-based indexing. Pages will be included in the document's natural order regardless of the specified range, and each page will only be included once. An empty string includes all pages.
Whether to prioritize page size defined in CSS using @page rules. When true, CSS page size takes precedence over the 'size' parameter. When false, content will be scaled to fit the specified paper size.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vortex PDF Documentation","colors":{"primary":"#0467c9","light":"#72DACA","dark":"#72DACA"},"logo":{"light":"https://mintcdn.com/ultimatemachine/3HvJ2shIR-BI6t3m/logo/vortex-logo-light.svg?fit=max\u0026auto=format\u0026n=3HvJ2shIR-BI6t3m\u0026q=85\u0026s=991c27f0619d1cf2a95586e20687fcf1","dark":"https://mintcdn.com/ultimatemachine/3HvJ2shIR-BI6t3m/logo/vortex-logo-dark.svg?fit=max\u0026auto=format\u0026n=3HvJ2shIR-BI6t3m\u0026q=85\u0026s=08faec6fa623baad57ec7e360c37b682"},"favicon":"/favicon.svg","navbar":{"links":[{"label":"Support","href":"mailto:support@vortexpdf.com"},{"label":"Status","href":"https://status.vortexpdf.com"},{"label":"Dashboard","href":"https://vortexpdf.com/dashboard"}]},"footer":{"socials":{"x":"https://x.com/vortexpdf","github":"https://github.com/vortexpdf","linkedin":"https://linkedin.com/company/vortexpdf"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ultimatemachine","hasAudioNarration":false,"actualSubdomain":"ultimatemachine","customDomains":["docs.vortexpdf.com"],"gitSource":{"type":"github","owner":"miickel","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e695044dd579e9b57ba9","collectionId":"ea871a00-74ac-4a43-a24f-942772f21776","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21e695044dd579e9b57ba9:success","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Page configuration","count":8},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Content handling","count":6},{"language":"default","tag":"Templates","count":5},{"language":"default","tag":"Asynchronous processing","count":2},{"language":"default","tag":"Output options","count":2},{"language":"default","tag":"Renderers","count":2},{"language":"default","tag":"Credits","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/renderers/create-pdf-asynchronously","slug":"/api-reference/renderers/create-pdf-asynchronously","pageMetadata":{"title":"Create PDF asynchronously","description":"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called. ","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi post /api/v1/renderers/pdf/async","href":"/api-reference/renderers/create-pdf-asynchronously","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: \"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\"\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":"Create PDF asynchronously","description":"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called. ","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi post /api/v1/renderers/pdf/async","href":"/api-reference/renderers/create-pdf-asynchronously","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{"onRenderComplete":{"{$request.body#/callback/url}":{"post":{"callbacks":{},"deprecated":false,"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message if the rendering failed","type":"string"},"result":{"properties":{"bucket":{"description":"The storage bucket name","type":"string"},"etag":{"description":"Entity tag for the stored object","type":"string"},"id":{"description":"Unique identifier for the stored object","type":"string"},"md5Hash":{"description":"MD5 hash of the file content","type":"string"},"mediaLink":{"description":"URL to download the generated PDF","type":"string"},"name":{"description":"The path to the generated PDF file","type":"string"},"size":{"description":"Size of the generated PDF file in bytes","type":"string"},"storageClass":{"description":"Storage class of the object","type":"string"},"timeCreated":{"description":"When the file was created in storage","format":"date_time","type":"string"}},"type":"object"},"status":{"description":"The final status of the rendering job","enum":["success","failed"],"type":"string"},"timestamp":{"description":"ISO8601 timestamp of when the job completed","format":"date_time","type":"string"}},"required":["status","timestamp"],"type":"object"}}},"description":"Callback payload with rendering job status","required":true},"responses":{"200":{"description":"Callback received successfully"}},"tags":[]}}}},"description":"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called. ","operationId":"VortexWeb.API.V1.RenderController.render_async","parameters":[],"requestBody":"2b59ff77-8bb9-46ce-8e1e-ae77815406bc","responses":{"200":"dfea1c15-9279-4f2e-b3ae-345b9d583499","401":"58e47aa6-6764-49b8-96dc-6d4b4e3ca820","403":"d12b1288-2b61-42e0-b745-2a821e77ab37","404":"9015067c-9cf9-4dd5-a536-fd30fad6e958","422":"48039a84-a130-4d29-b4ef-8e46e7e9101b"},"security":["e3ae3fa4-33e7-44ba-8136-dd1cb1c4b783"],"summary":"Create PDF asynchronously","tags":["Renderers"],"method":"post","type":"path","servers":["a0935974-d09f-42a4-8fbb-14b452670648"],"path":"/api/v1/renderers/pdf/async","baseUrlOptions":["https://vortexpdf.com"],"title":"Create PDF asynchronously","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"async_render_options","description":"Options for asynchronous PDF rendering, where the rendering happens in the background and the result is stored in the specified destination.","required":["parts"],"properties":{"parts":{"description":"An array of content parts to render into a single PDF. Each part can be a URL string, HTML content string, or a structured content object with type and content.","example":["https://example.com","\u003ch1>Hello World\u003c/h1>",{"content":"\u003cdiv>Structured HTML content\u003c/div>","type":"html"},{"content":{"context":{"customer_name":"Acme Inc."},"template_id":"invoice_template"},"type":"template"}],"items":{"oneOf":[{"type":"string","title":"url_string","description":"A content part that can be a URL string, HTML string, or a structured content object.","format":"uri","pattern":"^https?://\\S+","uniqueKey":"parts.items.[INDEX].oneOf.0","typeLabel":"string\u003curi>"},{"type":"string","title":"html_string","description":"A content part that can be a URL string, HTML string, or a structured content object.","pattern":"^\\s*\u003c[^>]+>","uniqueKey":"parts.items.[INDEX].oneOf.1","typeLabel":"string"},{"type":"object","title":"content_part","description":"A content part that can be a URL string, HTML string, or a structured content object.","required":["type","content"],"example":{"content":"https://example.com","type":"url"},"properties":{"content":{"oneOf":[{"type":"string","title":"content","description":"The content to render - either a URL string when type is 'url', HTML markup when type is 'html', or a template specification object when type is 'template'.","isRequired":true,"uniqueKey":"parts.items.[INDEX].oneOf.2.content.oneOf.0","typeLabel":"string"},{"type":"object","title":"template_content","description":"Template specification with context data for rendering into HTML","required":["template_id"],"example":{"context":{"customer_name":"Acme Inc.","invoice_number":"INV-2023-001","items":[{"description":"Product A","price":100,"quantity":2},{"description":"Product B","price":50,"quantity":1}]},"template_id":"invoice_template"},"properties":{"template_id":{"description":"Unique identifier for the template to use","title":"template_id","type":"string","isRequired":true,"uniqueKey":"parts.items.[INDEX].oneOf.2.content.oneOf.1.template_id","typeLabel":"string"},"context":{"additionalProperties":true,"description":"JSON object containing data to be inserted into the template","title":"context","type":"object","uniqueKey":"parts.items.[INDEX].oneOf.2.content.oneOf.1.context","typeLabel":"context · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"parts.items.[INDEX].oneOf.2.content.oneOf.1","typeLabel":"template_content · object"}],"isRequired":true,"uniqueKey":"parts.items.[INDEX].oneOf.2.content","typeLabel":"string | template_content · object"},"type":{"description":"The type of content to render - 'url' for a web page, 'html' for raw HTML content, or 'template' for template-based rendering.","enum":["url","html","template"],"title":"type","type":"string","isRequired":true,"uniqueKey":"parts.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"parts.items.[INDEX].oneOf.2","typeLabel":"content_part · object"}],"uniqueKey":"parts.items.[INDEX]","typeLabel":"string\u003curi> | string | content_part · object"},"maxItems":50,"minItems":1,"title":"content_parts","type":"array","isRequired":true,"uniqueKey":"parts","typeLabel":"(string\u003curi> | string | content_part · object)[]"},"emulate_media_type":{"default":"print","description":"Emulates the specified media type during rendering. Use 'screen' for web display styles or 'print' for print-optimized styles. Particularly useful for pages with different CSS for screen and print media queries.","enum":["screen","print"],"title":"emulate_media_type","type":"string","uniqueKey":"emulate_media_type","typeLabel":"enum\u003cstring>"},"evaluate_js":{"additionalProperties":false,"description":"Evaluates a JavaScript expression in the page context before rendering. Useful for manipulating the DOM, triggering actions, or waiting for dynamic content to load. If the expression returns a Promise, rendering will wait for it to resolve.","properties":{"expression":{"description":"The JavaScript expression to evaluate in the page context.","title":"expression","type":"string","isRequired":true,"uniqueKey":"evaluate_js.expression","typeLabel":"string"}},"required":["expression"],"title":"evaluate_js","type":"object","uniqueKey":"evaluate_js","typeLabel":"evaluate_js · object"},"footer_template":{"description":"HTML template for the page footer. Supports special classes like 'date', 'title', 'url', 'pageNumber', and 'totalPages' for dynamic content.","title":"footer_template","type":"string","uniqueKey":"footer_template","typeLabel":"string"},"header_template":{"description":"HTML template for the page header. Supports special classes like 'date', 'title', 'url', 'pageNumber', and 'totalPages' for dynamic content.","title":"header_template","type":"string","uniqueKey":"header_template","typeLabel":"string"},"include_backgrounds":{"default":true,"description":"Whether to include background images and colors in the rendered PDF. Set to false to optimize for printing or reduce file size.","title":"include_backgrounds","type":"boolean","uniqueKey":"include_backgrounds","typeLabel":"boolean"},"margin":{"additionalProperties":false,"default":{"bottom":0,"left":0,"right":0,"top":0,"unit":"mm"},"description":"Document margins specification with unit. Controls the space between the page edges and content.","example":{"bottom":10,"left":10,"right":10,"top":10,"unit":"mm"},"properties":{"bottom":{"description":"Bottom margin in the specified unit","minimum":0,"type":"number","isRequired":true,"uniqueKey":"margin.bottom","typeLabel":"number"},"left":{"description":"Left margin in the specified unit","minimum":0,"type":"number","isRequired":true,"uniqueKey":"margin.left","typeLabel":"number"},"right":{"description":"Right margin in the specified unit","minimum":0,"type":"number","isRequired":true,"uniqueKey":"margin.right","typeLabel":"number"},"top":{"description":"Top margin in the specified unit","minimum":0,"type":"number","isRequired":true,"uniqueKey":"margin.top","typeLabel":"number"},"unit":{"default":"mm","description":"Measurement unit for margin dimensions","enum":["mm","cm","in","px"],"type":"string","uniqueKey":"margin.unit","typeLabel":"enum\u003cstring>"}},"required":["top","right","bottom","left"],"title":"margin","type":"object","uniqueKey":"margin","typeLabel":"margin · object"},"orientation":{"default":"portrait","description":"Page orientation for the PDF. 'portrait' is taller than wide, 'landscape' is wider than tall.","enum":["portrait","landscape"],"title":"orientation","type":"string","uniqueKey":"orientation","typeLabel":"enum\u003cstring>"},"output_format":{"default":"pdf/a","description":"Output file format. 'pdf/a' is PDF/A-2b compliant for archiving, while 'pdf' is standard PDF.","enum":["pdf/a","pdf"],"title":"output_format","type":"string","uniqueKey":"output_format","typeLabel":"enum\u003cstring>"},"pages":{"default":"","description":"Specifies which pages to include in the output using a comma-separated list of page ranges (e.g., '1-5, 8, 11-13'). Uses one-based indexing. Pages will be included in the document's natural order regardless of the specified range, and each page will only be included once. An empty string includes all pages.","pattern":"^$|^(\\d+(-\\d+)?)(,\\s*(\\d+(-\\d+)?))*$","title":"pages","type":"string","uniqueKey":"pages","typeLabel":"string"},"prefer_css_page_size":{"default":false,"description":"Whether to prioritize page size defined in CSS using @page rules. When true, CSS page size takes precedence over the 'size' parameter. When false, content will be scaled to fit the specified paper size.","title":"prefer_css_page_size","type":"boolean","uniqueKey":"prefer_css_page_size","typeLabel":"boolean"},"render_header_footer":{"default":false,"description":"Whether to render the header and footer templates on each page. Must be true for header_template and footer_template to take effect.","title":"render_header_footer","type":"boolean","uniqueKey":"render_header_footer","typeLabel":"boolean"},"scale":{"default":1,"description":"Scale factor for the webpage rendering. Values below 1.0 reduce size, above 1.0 enlarge content.","maximum":2,"minimum":0.1,"title":"scale","type":"number","uniqueKey":"scale","typeLabel":"number"},"set_cookie":{"additionalProperties":false,"description":"Sets a cookie before rendering, useful for authenticated content or personalized views.","properties":{"domain":{"description":"Cookie domain (must match the domain of the URL being rendered)","type":"string","isRequired":true,"uniqueKey":"set_cookie.domain","typeLabel":"string"},"name":{"description":"Cookie name","type":"string","isRequired":true,"uniqueKey":"set_cookie.name","typeLabel":"string"},"value":{"description":"Cookie value","type":"string","isRequired":true,"uniqueKey":"set_cookie.value","typeLabel":"string"}},"required":["name","value","domain"],"title":"set_cookie","type":"object","uniqueKey":"set_cookie","typeLabel":"set_cookie · object"},"size":{"oneOf":[{"type":"string","title":"size_preset","description":"Standard document size preset name.","default":"a4","enum":["a0","a1","a2","a3","a4","a5","a6","a7","a8","a9","a10","letter","legal","tabloid","ledger"],"example":"a4","uniqueKey":"size.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","title":"size_custom","description":"Custom document size dimensions with unit.","default":"a4","required":["width","height"],"example":"a4","properties":{"height":{"description":"Document height in the specified unit.","type":"number","isRequired":true,"uniqueKey":"size.oneOf.1.height","typeLabel":"number"},"width":{"description":"Document width in the specified unit.","type":"number","isRequired":true,"uniqueKey":"size.oneOf.1.width","typeLabel":"number"},"unit":{"default":"mm","description":"Measurement unit for dimensions.","enum":["mm","cm","in","px"],"type":"string","uniqueKey":"size.oneOf.1.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"size.oneOf.1","typeLabel":"size_custom · object"}],"uniqueKey":"size","typeLabel":"enum\u003cstring> | size_custom · object"},"wait_for":{"additionalProperties":false,"description":"Waits for a specific element attribute to be set before rendering, useful for ensuring dynamic content is fully loaded.","properties":{"attribute":{"description":"The attribute name to wait for on the selected element. Rendering will proceed once this attribute exists on the element.","title":"attribute","type":"string","isRequired":true,"uniqueKey":"wait_for.attribute","typeLabel":"string"},"selector":{"description":"CSS selector for the element to wait for (e.g., '#content' or '.ready').","title":"selector","type":"string","isRequired":true,"uniqueKey":"wait_for.selector","typeLabel":"string"}},"required":["selector","attribute"],"title":"wait_for","type":"object","uniqueKey":"wait_for","typeLabel":"wait_for · object"},"callback":{"additionalProperties":false,"description":"Callback configuration for notification when the asynchronous rendering is complete.","properties":{"url":{"description":"URL that will receive a POST request when rendering is complete, including status and file location information.","format":"uri","title":"url","type":"string","isRequired":true,"uniqueKey":"callback.url","typeLabel":"string\u003curi>"},"headers":{"additionalProperties":{"type":"string","uniqueKey":"callback.headers.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include in the callback request, useful for authentication or request identification.","title":"headers","type":"object","uniqueKey":"callback.headers","typeLabel":"headers · object"}},"required":["url"],"title":"callback","type":"object","uniqueKey":"callback","typeLabel":"callback · object"},"destination":{"additionalProperties":false,"description":"Configuration specifying where the rendered PDF should be stored when using asynchronous rendering.","example":{"bucket":"my-bucket","path":"pdfs/document.pdf","provider":"aws_s3"},"properties":{"bucket":{"description":"The storage bucket name where the PDF will be stored.","title":"bucket","type":"string","isRequired":true,"uniqueKey":"destination.bucket","typeLabel":"string"},"path":{"description":"Storage path within the bucket, including the filename (e.g., 'pdfs/document.pdf').","title":"path","type":"string","isRequired":true,"uniqueKey":"destination.path","typeLabel":"string"},"provider":{"description":"The cloud storage provider to use for storing the generated PDF.","enum":["aws_s3","google_cloud_storage"],"title":"provider","type":"string","isRequired":true,"uniqueKey":"destination.provider","typeLabel":"enum\u003cstring>"}},"required":["provider","bucket","path"],"title":"cloud_destination","type":"object","uniqueKey":"destination","typeLabel":"cloud_destination · object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"async_render_options · object"},"examples":{"Example":{"title":"Example","value":{"parts":["https://example.com","\u003ch1>Hello World\u003c/h1>",{"content":"\u003cdiv>Structured HTML content\u003c/div>","type":"html"},{"content":{"context":{"customer_name":"Acme Inc."},"template_id":"invoice_template"},"type":"template"}],"emulate_media_type":"print","footer_template":"\u003cstring>","header_template":"\u003cstring>","include_backgrounds":true,"margin":{"bottom":10,"left":10,"right":10,"top":10,"unit":"mm"},"orientation":"portrait","output_format":"pdf/a","pages":"","prefer_css_page_size":false,"render_header_footer":false,"scale":1,"size":"a4","destination":{"bucket":"my-bucket","path":"pdfs/document.pdf","provider":"aws_s3"}}}},"exampleType":"generated"}},"description":"Render async options","required":true,"exampleType":"generated"},"responses":{"dfea1c15-9279-4f2e-b3ae-345b9d583499":{"content":{"application/json":{"schema":{"description":"Standard success response","example":{"status":"success"},"properties":{"status":{"description":"Status of the operation","enum":["success"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["status"],"title":"success_response","type":"object","uniqueKey":"","typeLabel":"success_response · object"},"examples":{"Example":{"title":"Example","value":{"status":"success"}}},"exampleType":"generated"}},"description":"Success","exampleType":"generated"},"58e47aa6-6764-49b8-96dc-6d4b4e3ca820":{"content":{"application/json":{"schema":{"description":"Response when authentication or authorization fails","example":{"error":"unauthorized","message":"Authentication required to access this resource"},"properties":{"error":{"description":"Error message describing the authentication or authorization failure","enum":["unauthorized","forbidden","invalid_token","expired_token","insufficient_permissions"],"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"A more detailed message explaining the error","type":"string","uniqueKey":"message","typeLabel":"string"}},"required":["error"],"title":"auth_error_response","type":"object","uniqueKey":"","typeLabel":"auth_error_response · object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"Authentication required to access this resource"}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"d12b1288-2b61-42e0-b745-2a821e77ab37":{"content":{"application/json":{"schema":{"description":"Response when authentication or authorization fails","example":{"error":"unauthorized","message":"Authentication required to access this resource"},"properties":{"error":{"description":"Error message describing the authentication or authorization failure","enum":["unauthorized","forbidden","invalid_token","expired_token","insufficient_permissions"],"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"A more detailed message explaining the error","type":"string","uniqueKey":"message","typeLabel":"string"}},"required":["error"],"title":"auth_error_response","type":"object","uniqueKey":"","typeLabel":"auth_error_response · object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"Authentication required to access this resource"}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"9015067c-9cf9-4dd5-a536-fd30fad6e958":{"content":{"application/json":{"schema":{"description":"Response when an error occurs","properties":{"error":{"properties":{"message":{"description":"Error message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"title":"error_response","type":"object","uniqueKey":"","typeLabel":"error_response · object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Resource not found","exampleType":"generated"},"48039a84-a130-4d29-b4ef-8e46e7e9101b":{"content":{"application/json":{"schema":{"properties":{"errors":{"items":{"properties":{"detail":{"example":"null value where string expected","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"properties":{"pointer":{"example":"/data/attributes/petName","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"required":["pointer"],"type":"object","isRequired":true,"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"title":{"example":"Invalid value","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"}},"required":["title","source","detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"title":"JsonErrorResponse","type":"object","uniqueKey":"","typeLabel":"JsonErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"null value where string expected","source":{"pointer":"/data/attributes/petName"},"title":"Invalid value"}]}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"}},"security":{"e3ae3fa4-33e7-44ba-8136-dd1cb1c4b783":{"authorization":{"description":"Manage your API keys at https://vortexpdf.com/api-keys","scheme":"bearer","type":"http","scopes":[]}}},"servers":{"a0935974-d09f-42a4-8fbb-14b452670648":{"url":"https://vortexpdf.com","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Manage your API keys at https://vortexpdf.com/api-keys","scheme":"bearer","type":"http","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Manage your API keys at https://vortexpdf.com/api-keys","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"https://vortexpdf.com/openapi"},"subdomain":"ultimatemachine","siteName":"Vortex PDF Documentation","title":"Create PDF asynchronously - Vortex PDF Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T06:50:12.653Z","originalFileLocation":"api-reference/renderers/create-pdf-asynchronously.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=\"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vortex PDF 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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_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/ultimatemachine/nOQyTUjKdTu37Dg9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create PDF asynchronously - Vortex PDF Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vortex PDF Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ultimatemachine.mintlify.app/_mintlify/api/og/v2?division=Renderers\u0026amp;title=Create+PDF+asynchronously\u0026amp;description=Generate+a+PDF+from+one+or+more+content+sources+in+the+background+and+store+it+in+the+specified+cloud+destination.+Content+can+be+provided+as+URLs+to+fetch%2C+raw\u0026amp;theme=7310db011bfe049804f58f29\u0026amp;signature=bca427c29c7f4acefd8bc048d4beb4d6f41db3488d55789297cb0eb8d400943e\">\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=\"Create PDF asynchronously - Vortex PDF Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ultimatemachine.mintlify.app/_mintlify/api/og/v2?division=Renderers\u0026amp;title=Create+PDF+asynchronously\u0026amp;description=Generate+a+PDF+from+one+or+more+content+sources+in+the+background+and+store+it+in+the+specified+cloud+destination.+Content+can+be+provided+as+URLs+to+fetch%2C+raw\u0026amp;theme=7310db011bfe049804f58f29\u0026amp;signature=bca427c29c7f4acefd8bc048d4beb4d6f41db3488d55789297cb0eb8d400943e\">\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/ultimatemachine/nOQyTUjKdTu37Dg9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vortex PDF Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0467c9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/renderers/create-pdf-asynchronously.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vortexpdf.com/#organization\",\"name\":\"Vortex PDF Documentation\",\"url\":\"https://docs.vortexpdf.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ultimatemachine/3HvJ2shIR-BI6t3m/logo/vortex-logo-light.svg?fit=max\u0026auto=format\u0026n=3HvJ2shIR-BI6t3m\u0026q=85\u0026s=991c27f0619d1cf2a95586e20687fcf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vortexpdf.com#website\",\"name\":\"Vortex PDF Documentation\",\"url\":\"https://docs.vortexpdf.com\",\"publisher\":{\"@id\":\"https://docs.vortexpdf.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously#webpage\",\"url\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously\",\"name\":\"Create PDF asynchronously\",\"description\":\"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\",\"dateModified\":\"2026-01-07T06:50:12.653Z\",\"isPartOf\":{\"@id\":\"https://docs.vortexpdf.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Renderers\",\"item\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-synchronously\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create PDF asynchronously\",\"item\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously#apireference\",\"headline\":\"Create PDF asynchronously\",\"name\":\"Create PDF asynchronously\",\"description\":\"Generate a PDF from one or more content sources in the background and store it in the specified cloud destination. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. This endpoint returns immediately with a success status while the rendering happens asynchronously. When rendering completes, the PDF will be uploaded to the specified destination, and an optional callback URL will be called.\",\"url\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vortexpdf.com/api-reference/renderers/create-pdf-asynchronously#webpage\"},\"dateModified\":\"2026-01-07T06:50:12.653Z\",\"publisher\":{\"@id\":\"https://docs.vortexpdf.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vortexpdf.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vortex PDF Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vortex PDF Documentation","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Credits","pages":[{"title":"Get credits usage","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi get /api/v1/credits","href":"/api-reference/credits/get-credits-usage"}]},{"group":"Vortex","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi get /api/v1/health","href":"/api-reference/vortex/health-check"}]},{"group":"Renderers","pages":[{"title":"Create PDF synchronously","description":"Generate a PDF from one or more content sources and return it directly in the response. Content can be provided as URLs to fetch, raw HTML strings, or a combination of both. The response will contain the generated PDF file. ","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi post /api/v1/renderers/pdf","href":"/api-reference/renderers/create-pdf-synchronously"},{"title":"Create PDF asynchronously","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi post /api/v1/renderers/pdf/async","href":"/api-reference/renderers/create-pdf-asynchronously"}]},{"group":"Templates","pages":[{"title":"List templates","description":"List all templates for the authenticated user","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi get /api/v1/templates","href":"/api-reference/templates/list-templates"},{"title":"Create template","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi post /api/v1/templates","href":"/api-reference/templates/create-template"},{"title":"Get template","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi get /api/v1/templates/{id}","href":"/api-reference/templates/get-template"},{"title":"Delete template","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi delete /api/v1/templates/{id}","href":"/api-reference/templates/delete-template"},{"title":"Update template","deprecated":null,"version":null,"openapi":"https://vortexpdf.com/openapi patch /api/v1/templates/{id}","href":"/api-reference/templates/update-template"}]}]}]},"title":"Create PDF asynchronously - Vortex PDF Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}