API endpoint to convert ADF (Atlassian Document Format) to wiki/text format?

[Asier Vadillo]

Hello all —

We are using a Python script to retrieve the summary and description from Jira issues, and then publishing them into our private wiki. Since Jira fields now store rich text as ADF (Atlassian Document Format), we are losing list bullet items and other formatting.

My question:
Does the Jira REST API provide a supported endpoint to convert ADF → wiki markup, Markdown, HTML or plaintext? If yes, could someone share endpoint/usage example? If not, what is the recommended approach (official or best practice) for this kind of conversion?

Thanks in advance for any pointers, sample code or library suggestions.

[Andy Rusnak]

Hi Asier, 

Thanks for posting the question to the Community and I hope you are doing well!  

Currently there is not a REST API endpoint to convert between these various formats however we do have JRACLOUD-77436 which requests this type of functionality.  I would encourage you to vote and watch JRACLOUD-77436 to let our team know this is something you are interested in and get updates on it.  

In terms of a workaround, there is a workaround mentioned on JRACLOUD-77436 by leveraging the 'expand' parameter of the normal GET issues or GET comments endpoints.  For example, when getting an issue field you get the issue and use the "expand=renderedFields" which will return an HTML rendition of the fields as outlined within the Jira Cloud REST API documentation.

Would that be something that might work for you? 

Best, 

Andy