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:

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

Permissions required: 'View' permission for the space, and permission to view the content if the spaceKeyContext or contentIdContext are present.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
conversionInputs[] Array No
conversionInputs[].to String Yes

The name of the target format for the content body conversion.

conversionInputs[].contentIdContext String No

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.

conversionInputs[].spaceKeyContext String No

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.

conversionInputs[].expand[] Array No

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
conversionInputs[].embeddedContentRender String No

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.

Valid values:

  • "version-at-save"
  • "current"

Default value: "current"

conversionInputs[].body Object Yes

This object is used when creating or updating content.

conversionInputs[].body.representation String Yes

The content format type. Set the value of this property to the name of the format being used, e.g. 'storage'.

Valid values:

  • "editor"
  • "wiki"
  • "atlas_doc_format"
  • "export_view"
  • "storage"
  • "plain"
  • "raw"
  • "view"
  • "styled_view"
  • "editor2"
  • "anonymous_export_view"
conversionInputs[].body.value String Yes

The body of the content in the relevant format.

conversionInputs[].allowCache Boolean No

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

Default value: false

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.