How to write a good description using jira rest api

[Prateek Vyas]

Hi i want to write a good description using heading and bullet list using JIRA REST API.
But i didn't get any example in the documentation like how i can use heading etc. 

Right now i am sending this payload in the api.

{

"fields": {

"labels": [

"new_release"

],

"components": [

{

"id": "28802"

}

],

"duedate": "2026-03-03",

"priority": {

"name": "Low"

},

"description": {

"content": [

{

"content": [

{

"text": "what is the project about?",

"type": "text"

}

],

"type": "paragraph"

}

],

"type": "doc",

"version": 1

},

"project": {

"id": "31500"

},

"issuetype": {

"id": "3"

},

"summary": "My Engage Project"

},

"update": {}

}

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post

[Rebekka Heilmann (viadee) · Accepted solution]

Hi @Prateek Vyas 

are you looking for the correct structure to achieve Headings, Bulletlists etc.?

Maybe the Document Builder is helpful for you: Document builder

You can write formatted text in the WYSIWYG-Editor and it gives you the ADF version ready to be pasted into your JSON.

[Marc - Devoteam · Accepted solution]

Hi @Prateek Vyas 

You need to use the Atlassian Document Format