---
title: "Create asynchronous content body conversion tasks in bulk"
method: POST
path: "/wiki/rest/api/contentbody/convert/async/bulk/tasks"
tags: ["Content body"]
---

# Create asynchronous content body conversion tasks in bulk

`POST /wiki/rest/api/contentbody/convert/async/bulk/tasks`

Asynchronously converts content bodies from one format to another format in bulk. Use the Content body
REST API to get the status of conversion tasks. Note that there is a maximum limit of 10 conversions per
request to this endpoint.

Supported conversions:

- storage: editor, export_view, styled_view, view
- editor: storage

Once a conversion task is completed, it is available for polling for up to 5 minutes.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'View' permission for the space, and permission to view the content if the `spaceKeyContext` or
`contentIdContext` are present.

## Request body

- BulkContentBodyConversionInput
  - `conversionInputs` ContentBodyConversionInput[]
    - `to` string, required — The name of the target format for the content body conversion.
    - `allowCache` boolean — Controls whether conversion results are cached and reused for identical requests. - `false`: Each request creates a new conversion task, even if an identical request was made previously. - `true`: Enables caching behavior for identical requests from the same user. - If no cached result exists, a new conversion task is created - If a cached result exists, the existing task is marked as RERUNNING and will complete with status COMPLETED - Returns the same task ID for identical requests, allowing you to retrieve the cached result
    - `spaceKeyContext` string — The space key used for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link `<ac:link><ri:page ri:content-title="Example page" /><ac:link>` and the `spaceKeyContext=TEST` parameter is provided, then the link will be converted into a link to the "Example page" page in the "TEST" space.
    - `contentIdContext` string — The content ID used to find the space for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link `<ac:link><ri:page ri:content-title="Example page" /><ac:link>` and the `contentIdContext=123` parameter is provided, then the link will be converted into a link to the "Example page" page in the same space that has the content with ID=123. Note that `spaceKeyContext` will be ignored if this parameter is provided.
    - `embeddedContentRender` 'current' | 'version-at-save' — Mode used for rendering embedded content, such as attachments. - `current` renders the embedded content using the latest version. - `version-at-save` renders the embedded content using the version at the time of save.
    - `expand` string[] — A multi-value, comma-separated parameter indicating which properties of the content to expand and populate. Expands are dependent on the `to` conversion format and may be irrelevant for certain conversions (e.g. `macroRenderedOutput` is redundant when converting to `view` format). If rendering to `view` format, and the body content being converted includes arbitrary nested content (such as macros); then it is necessary to include webresource expands in the request. Webresources for content body are the batched JS and CSS dependencies for any nested dynamic content (i.e. macros). - `embeddedContent` returns metadata for nested content (e.g. page included using page include macro) - `mediaToken` returns JWT token for retrieving attachment data from Media API - `macroRenderedOutput` additionally converts body to view format - `webresource.superbatch.uris.js` returns all common JS dependencies as static URLs - `webresource.superbatch.uris.css` returns all common CSS dependencies as static URLs - `webresource.superbatch.uris.all` returns all common dependencies as static URLs - `webresource.superbatch.tags.all` returns all common JS dependencies as html `<script>` tags - `webresource.superbatch.tags.css` returns all common CSS dependencies as html `<style>` tags - `webresource.superbatch.tags.js` returns all common dependencies as html `<script>` and `<style>` tags - `webresource.uris.js` returns JS dependencies specific to conversion - `webresource.uris.css` returns CSS dependencies specific to conversion - `webresource.uris.all` returns all dependencies specific to conversion - `webresource.tags.all` returns common JS dependencies as html `<script>` tags - `webresource.tags.css` returns common CSS dependencies as html `<style>` tags - `webresource.tags.js` returns common dependencies as html `<script>` and `<style>` tags
    - `body` ContentBodyCreate, required — This object is used when creating or updating content.
      - `value` string, required — The body of the content in the relevant format.
      - `representation` 'view' | 'export_view' | 'styled_view' | 'storage' | 'editor' | 'editor2' | 'anonymous_export_view' | 'wiki' | 'atlas_doc_format' | 'plain' | 'raw', required — The content format type. Set the value of this property to the name of the format being used, e.g. 'storage'.

## Response `200`

Returned if asynchronous tasks are created to convert content bodies. If a conversion task fails to be created, a “FAILED_TO_QUEUE” string will be returned instead of an asyncId.

- AsyncId[]
  - `asyncId` string, required

## Other responses

- `400` — Returned if there are more than 10 conversions requested.

---

[API](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)