How do you create a Jira issue with code snippet in the description using REST API?

Question

I am trying to create a Jira issue with a code snippet in the description.

I am new to the Atlassian REST API, so help would be much appreciated.

Also, a link to what kinds of formatting the description field can take for creating a Jira issue would be much appreciated.

Nir Haimov · Accepted Answer

Hi,

You need to send a POST call to:
https://your_jira_url/rest/api/2/issue/{issueKey}/comment

add header:
"Content-Type", "application/json"

your body data should be like:
{
    "body": "{code:java}// code placeholder{code}"
}

James Jung_rnkd60 · Accepted Answer

After many trials and errors and trying to see what the Jira UI was sending to its backend, I tried something like this as the JSON body with a POST call to "/rest/api/3/issue/" to create an issue:

{
    "fields": {
        "summary": "Some Summary",
        "description": {
            "version": 1,
            "type": "doc",
            "content": [
                {
                    "type": "codeBlock",
                    "attrs": { 
                        "language": "javascript"
                    },
                    "content": [
                        {
                            "type": "text",
                            "text": "some code here with proper escapes"
                        }
                    ]
                }
            ]
        },
        "project": {
            "key": "some_key"
        },
        "priority": {
            "id": "some_priority"
        },
        "issuetype": {
            "name": "some_issue_type"
        }
    }
}

I'm not sure what the best way to do this is, so I think there needs to be more documentation and examples. Maybe I am looking at the wrong places, but the documentation looks a little sparse.

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

I would like to know what attributes I can mess around with for "description", but the "fields" attribute is just an object without any explanation of how to utilize the "description" attribute inside of it.