# Export
{% hint style="info" %}
Export endpoints are part of the [Content Services API](https://docs.beefree.io/beefree-sdk/~/changes/480/apis/content-services-api). The Content Services API is available on [Beefree SDK plans that are Essentials or above](https://developers.beefree.io/pricing-plans).
{% endhint %}
## Overview
The Export category is one of the most common uses of the Content Services API. After creating a design in the no-code builder, end users often need to export and share it. These endpoints let you offer multiple export options—including HTML, plain text, PDF, and image formats—so your users can easily distribute their finished designs.
### Available Collection Values for Export Endpoints
The following table lists the collection values available in this category of endpoints, and their corresponding collection options.
Prior to referencing the table, the following example shows how you can replace the **{collection}** placeholder based on the type of content you'd like to export.
#### How to Replace the {collection} Placeholder
The following example URL has a **{collection}** placeholder. This placeholder needs to be filled in with a **Collection Option** prior to making an API call.
`https://api.getbee.io/v1/{collection}/html`
As an example, if you'd like to export an email's HTML using this endpoint, replace **{collection}** with **message**.
The final URL to make the API call will be:
`https://api.getbee.io/v1/message/html`
The following table provides a comprehensive reference of all available options based on what you'd like to export.
| Resource | Collection Options |
| ------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `/html` | |
| `/plain-text` | |
| `/pdf` | |
| `/image` | |
## HTML
**URL:** `https://api.getbee.io/v1/{collection}/html`
This endpoint allows you to retrieve the full or partial HTML output of a template (email, page, or popup).
{% hint style="info" %}
**Important:** `collection` is a placeholder within the URL. This placeholder can be replaced with any of the `collection` options available for the HTML resource. Reference the [Export Resource and Collection Options table](https://docs.beefree.io/beefree-sdk/~/changes/480/apis/content-services-api/..#export) for a list of available option.
{% endhint %}
#### How It Works
To generate HTML from a template's JSON:
1. Capture or store the latest JSON output from the builder using [callbacks](https://docs.beefree.io/beefree-sdk/~/changes/480/getting-started/readme/installation/methods-and-events) such as `onChange` or `autosave`.
2. Send this JSON payload to the HTML endpoint.
3. Receive the HTML string as the response.
#### Required Request Payload
```json
{
"page": {
"body": { ... },
...
}
}
```
* `page` (object, required): The full template structure in Beefree JSON format. This is the same structure returned by the builder or captured from its callbacks.
#### Notes
* This endpoint bypasses the need for the `onSave` callback and can be used at any time post-editing.
* Partial HTML rendering is also supported for specific components or modules (if required by your use case).
* The output HTML reflects the current rendering engine used by Beefree, ensuring up-to-date compatibility.
{% openapi src="" path="/v1/{collection}/html" method="post" %}
[html\_endpoint.yaml](https://806400411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8c7XIQHfAtM23Dp3ozIC%2Fuploads%2Fa3lSukpFEcbPYPVzjVIz%2Fhtml_endpoint.yaml?alt=media\&token=f7b58600-763b-45ab-98c8-1877a24bd4c0)
{% endopenapi %}
## Plain Text
**URL:** `https://api.getbee.io/v1/{collection}/html`
This endpoint allows you to retrieve the plain text version of an email.
{% hint style="info" %}
**Important:** `collection` is a placeholder within the URL. This placeholder can be replaces with any of the `collection` options available for the Plain Text resource. Reference the [Export Resource and Collection Options table](https://docs.beefree.io/beefree-sdk/~/changes/480/apis/content-services-api/..#export) for a list of available option.
{% endhint %}
#### How It Works
To generate plain text from a template's JSON:
1. Capture or store the latest JSON output from the builder using [callbacks](https://docs.beefree.io/beefree-sdk/~/changes/480/getting-started/readme/installation/methods-and-events) such as `onChange` or `autosave`.
2. Send this JSON payload to the `/plain-text` endpoint.
3. Receive the plain text as the response.
{% openapi src="" path="/v1/{collection}/plain-text" method="post" %}
[plain\_text\_endpoint.yaml](https://806400411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8c7XIQHfAtM23Dp3ozIC%2Fuploads%2FEDXE2wtfc77B5cWtzADx%2Fplain_text_endpoint.yaml?alt=media\&token=4639676b-5852-4b66-a690-470489969e67)
{% endopenapi %}
## PDF
**URL:** `https://api.getbee.io/v1/{collection}/pdf`
You can generate a PDF file from valid HTML content using the dedicated PDF generation endpoint. This operation requires a JSON payload with specific fields to configure the output.
{% hint style="info" %}
**Important:** `collection` is a placeholder within the URL. This placeholder can be replaces with any of the `collection` options available for the PDF resource. Reference the [Export Resource and Collection Options table](https://docs.beefree.io/beefree-sdk/~/changes/480/apis/content-services-api/..#export) for a list of available option.
{% endhint %}
#### Required Request Payload
```json
{
"page_size": "Full",
"page_orientation": "landscape",
"html": "...