apyhub
FILE CONVERSION

Convert Presentations to PDF API

Hosted on ApyHub

What it does

Presentation to PDF converts PowerPoint and OpenDocument presentation files into PDF output. Send a .ppt, .pptx, or .odp file, or pass a base64-encoded presentation or remote presentation URL, and get back either a PDF download or a signed PDF link.

Use Presentation to PDF when you need a presentation rendered for sharing, archiving, review, or downstream document workflows. The service supports both file uploads and URL/base64 inputs, so you can convert content from a browser form, a storage bucket, or an upstream API without changing your pipeline.

Each conversion accepts an optional landscape boolean, which defaults to true, to control the output orientation. For file uploads, you can also set an output query value when requesting a download. The response is either binary PDF data or an object containing a data URI, depending on the endpoint you call.

If you need to standardize slide decks before sending them to customers, storing them in a document system, or feeding them into a review process, Presentation to PDF gives you a simple way to turn presentation formats into PDFs.

▣ ENDPOINT 01 / 06
POST
Convert base64-encoded presentation to PDF download
http://localhost:8080/apyhub/convert-presentation-to-pdf/base64/download
QUICKSTARTGUIDE

Quickstart

Convert a Base64-encoded presentation into a PDF download.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/base64/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"base64":"UEsDBAoAAAAAA..."}'

What you'll get back

Returns a binary file response containing the generated PDF.

TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Base64-encoded presentation file bytes (.ppt, .pptx, or .odp). Mandatory.

About this endpoint

What it does

Converts a base64-encoded presentation file into a PDF for download. You send the presentation bytes in the request body and can optionally control page orientation with a query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoControls the PDF orientation.<br>Default: true.

Request Body

ParameterTypeMandatoryDescription
base64StringYesBase64-encoded presentation file bytes. Supported input formats: .ppt, .pptx, .odp.

Response

Returns a binary PDF download. The output schema is a binary string, so the success response is the PDF file content itself rather than a JSON object.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 02 / 06
POST
Convert base64-encoded presentation to PDF signed link
http://localhost:8080/apyhub/convert-presentation-to-pdf/base64/link
QUICKSTARTGUIDE

Quickstart

Send a base64-encoded presentation file and get back a PDF URL.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/base64/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"base64":"UEsDBBQAAAAIA..."}'

What you'll get back

Returns a JSON object with a data string field containing the PDF URI.

{
  "data": "https://example.com/output.pdf"
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Base64-encoded presentation file bytes (.ppt, .pptx, or .odp). Mandatory.

About this endpoint

What it does

Converts a base64-encoded presentation file into a PDF and returns a signed link to the generated PDF. The request accepts the presentation bytes in the body and an optional landscape query parameter to control the output orientation.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoDefault: true. When true, generates the PDF in landscape orientation.

Request Body

ParameterTypeMandatoryDescription
base64StringYesBase64-encoded presentation file bytes. Supported formats: .ppt, .pptx, .odp.

Response

Returns a JSON object with a data string field formatted as a URI. The data field contains the signed link to the generated PDF.

ParameterTypeMandatoryDescription
dataStringYesSigned link to the generated PDF, returned as a URI.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 03 / 06
POST
Convert presentation upload to PDF download
http://localhost:8080/apyhub/convert-presentation-to-pdf/file/download
QUICKSTARTGUIDE

Quickstart

Upload a presentation file to convert it to PDF.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/file/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/presentation.pptx"

What you'll get back

Returns a binary file response containing the generated PDF.

TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Presentation file (.ppt, .pptx, or .odp). Mandatory.

About this endpoint

What it does

Converts an uploaded presentation file into a PDF and returns the resulting PDF as a binary download. The request sends the presentation in the body and can optionally control the output filename and orientation settings.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOutput filename for the downloaded PDF. Example: output.pdf.
landscapeBooleanNoControls the PDF layout orientation. Default: true.

Request Body

ParameterTypeMandatoryDescription
fileStringYesPresentation file to convert. Must be a .ppt, .pptx, or .odp file. Binary upload.

Response

Returns a binary file download containing the converted PDF. The output schema is a binary string, so the success response is the PDF file itself rather than a JSON object.

Query parameters

Name
Type
Description
outputOPTIONAL
string
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 04 / 06
POST
Convert presentation upload to PDF signed link
http://localhost:8080/apyhub/convert-presentation-to-pdf/file/link
QUICKSTARTGUIDE

Quickstart

Upload a presentation file to convert it to PDF.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/file/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/presentation.pptx"

What you'll get back

Returns a JSON object with a data string field containing the PDF file URI.

{
  "data": "https://example.com/converted-file.pdf"
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Presentation file (.ppt, .pptx, or .odp). Mandatory.

About this endpoint

What it does

Converts an uploaded presentation file into a PDF and returns a signed link to the generated PDF. The request body must include the presentation file, and you can optionally set whether the output should be landscape-oriented.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoWhether the output PDF should be landscape-oriented. Default: true.

Request Body

ParameterTypeMandatoryDescription
fileStringYesPresentation file to convert. Must be a binary upload in .ppt, .pptx, or .odp format.

Response

Returns a JSON object with a data string field containing a URI to the generated PDF signed link.

ParameterTypeMandatoryDescription
dataStringYesSigned link to the generated PDF, as a URI.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 05 / 06
POST
Convert remote presentation URL to PDF download
http://localhost:8080/apyhub/convert-presentation-to-pdf/url/download
QUICKSTARTGUIDE

Quickstart

Convert a presentation from a URL to PDF by sending the source file URL.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.pptx"}'

What you'll get back

Returns a binary file response containing the converted PDF.

TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Converts a remote presentation file from the URL you provide into a PDF and returns the generated PDF as a binary response. The request accepts the source presentation URL in the body and an optional landscape query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoSets the PDF orientation. Default: true.

Request Body

ParameterTypeMandatoryDescription
urlStringYesThe remote presentation file URL to convert. Format: URI.

Response

Returns a binary file response containing the generated PDF. The output schema is a binary string, so the success response is the PDF content itself.

ParameterTypeMandatoryDescription
binaryStringYesThe PDF file content returned by the endpoint.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 06 / 06
POST
Convert remote presentation URL to PDF signed link
http://localhost:8080/apyhub/convert-presentation-to-pdf/url/link
QUICKSTARTGUIDE

Quickstart

Convert a presentation from a public URL to a PDF. Replace the sample URL with your own presentation link.

curl -X POST "http://localhost:8080/apyhub/convert-presentation-to-pdf/url/link?landscape=true" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://assets.apyhub.com/samples/sample.pptx"
  }'

What you'll get back

Returns a JSON object with a data string field containing the PDF file URL.

{
  "data": "https://..."
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Converts a remote presentation file at a URL into a PDF and returns a signed link to the generated PDF. The request body provides the source url, and an optional landscape query parameter controls the orientation used for the conversion.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoOptional orientation flag for the output PDF. Default: true.

Request Body

ParameterTypeMandatoryDescription
urlStringYesRemote presentation file URL. Must be a valid URI.

Response

Returns a JSON object with a data string field containing a URI to the generated PDF signed link.

ParameterTypeMandatoryDescription
dataStringYesURI of the generated PDF signed link.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT true

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.