---
title: "Asynchronously convert content body"
method: POST
path: "/wiki/rest/api/contentbody/convert/async/{to}"
tags: ["Content body"]
---

# Asynchronously convert content body

`POST /wiki/rest/api/contentbody/convert/async/{to}`

Converts a content body from one format to another format asynchronously.
Returns the asyncId for the asynchronous task.

Supported conversions:

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

No other conversions are supported at the moment.
Once a conversion is completed, it will be available for 5 minutes at the result endpoint.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
If request specifies 'contentIdContext', 'View' permission for the space, and permission to view the content.

## Path parameters

- `to` 'export_view', required

## Query parameters

- `expand` string[]
- `spaceKeyContext` string
- `contentIdContext` string
- `allowCache` boolean
- `embeddedContentRender` 'current' | 'version-at-save'

## Request body

- ContentBodyCreate — 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 the content is added to the messaging queue for conversion. This id will be available for 5 minutes after the conversion is complete.

- AsyncId
  - `asyncId` string, required

## Other responses

- `400` — Returned - if the content body or conversion context is invalid or null - if the value is improperly formed - any conversion type other than export_view
- `404` — Returned if content cannot be found with the provided context.

---

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