Atlassian Jira Service Desk

the atlassian jira service desk connector allows for streamlined automation of ticketing and customer support tasks within the jira service desk environment atlassian jira service desk is a versatile and collaborative service management platform that streamlines customer support and internal helpdesk operations this connector enables swimlane turbine users to automate ticketing workflows, manage customer requests, and enhance communication within jira service desk directly from the swimlane platform by integrating with atlassian jira service desk, users can create, update, and track service requests, attach files, add comments, and transition issues, all while maintaining a centralized view of security operations and customer interactions limitations none to date supported versions this atlassian jira service desk connector uses the latest version api additional docs https //developer atlassian com/cloud/jira/platform/rest/v3/intro/#authentication https //developer atlassian com/cloud/jira/service desk/rest/intro/#permissions https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api group request configuration prerequisites to effectively utilize the atlassian jira service desk connector with swimlane turbine, ensure you have the following prerequisites http bearer authentication with these parameters url endpoint for the jira service desk api access token personal access token for authenticating api requests http basic authentication with these parameters url endpoint for the jira service desk api username your jira service desk username api token a secure api token generated from your atlassian account for authentication purposes authentication methods bearer token authentication url the base url for your jira service desk instance access token a access token obtained through an oauth process for secure access http basic authentication url the base url for your jira service desk instance username your jira service desk username password a secure api token generated from your atlassian account for authentication purposes capabilities this atlassian jira service desk connector provides the following capabilities create customer request create request comment create comment with attachment get customer request by id or key get customer requests get request comment by id get request comments perform customer transition attach temporary file create customer request this method creates a customer request in a service desk the json request must include the service desk and customer request type, as well as any fields that are required for the request type a list of the fields required by a customer request type can be obtained using servicedesk/{servicedeskid}/requesttype/{requesttypeid}/field the fields required for a customer request type depend on the user's permissions raiseonbehalfof is not available to users who have the customer permission only requestparticipants is not available to users who have the customer permission only or if the feature is turned off for customers requestfieldvalues is a map of jira field ids and their values see field input formats, for details of each field's json semantics and the values they can take permissions required permission to create requests in the specified service desk atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request post create request comment this method creates a public or private (internal) comment on a customer request, with the comment visibility set by public the user recorded as the author of the comment permissions required user has add comments permission request limitations customers can set comments to public visibility only atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey comment post get customer request by id or key this method returns a customer request permissions required permission to access the specified service desk response limitations for customers, only a request they created, was created on their behalf, or they are participating in will be returned note requestfieldvalues does not include hidden fields to get a list of request type fields that includes hidden fields, see /rest/servicedeskapi/servicedesk/{servicedeskid}/requesttype/{requesttypeid}/field atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey get get customer requests this method returns all customer requests for the user executing the query the returned customer requests are ordered chronologically by the latest activity on each request for example, the latest status transition or comment permissions required permission to access the specified service desk response limitations for customers, the list returned will include request they created (or were created on their behalf) or are participating in only atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request get get request comment by id this method returns details of a customer request's comment permissions required permission to view the customer request response limitations customers can only view public comments on requests where they are the reporter or a participant whereas agents can see both internal and public comments atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey comment commentid get get request comments this method returns all comments on a customer request no permissions error is provided if, for example, the user doesn't have access to the service desk or request, the method simply returns an empty response permissions required permission to view the customer request response limitations customers are returned public comments only atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey comment get perform customer transition this method performs a customer transition on a customer request, changing its status (e g from open to in progress or done) use get customer transitions to obtain the transition id for the desired status change the request body includes the transition id and an optional additionalcomment permissions required permission to perform the transition on the request atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey transition post get customer transitions this method returns the list of transitions available for a customer request (e g in progress, done) use the transition id from the response when calling perform customer transition permissions required permission to access the request atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey transition get attach temporary file this method uploads one or more files as temporary attachments to a service desk the request must be sent as multipart/form data with the part name "file" the returned temporary attachment ids can be used in create comment with attachment or in create customer request (form answers for file form fields) requires header x atlassian token no check; use x experimentalapi opt in if required by your instance permissions required permission to add attachments in the service desk atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group servicedesk/#api rest servicedeskapi servicedesk servicedeskid attachtemporaryfile post create comment with attachment this method creates a comment on a customer request and attaches one or more files file(s) must first be uploaded using attach temporary file; pass the returned temporary attachment ids in the request body along with public (visibility) and optional additionalcomment body permissions required permission to add comments and attachments to the request atlassian jira service desk documentation for this action can be found https //developer atlassian com/cloud/jira/service desk/rest/api group request/#api rest servicedeskapi request issueidorkey attachment post configurations jira service desk http basic authentication authenticates using username and api token configuration parameters parameter description type required url a url to the target host string required username username string required password a secure api token generated from your atlassian account for authentication purposes string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional jira service desk http bearer authentication authenticates using access token configuration parameters parameter description type required url a url to the target host string required token a bearer access token obtained through an oauth process for secure access string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions attach temporary file uploads a file as a temporary attachment to a specified service desk in atlassian jira service desk, providing ids for further operations endpoint url /rest/servicedeskapi/servicedesk/{{servicedeskid}}/attachtemporaryfile method post input argument name type required description path parameters servicedeskid string required the id of the service desk to upload the temporary file(s) to file object required eml file file file string optional parameter for attach temporary file file file name string optional name of the resource input example {"path parameters" {"servicedeskid" "10001"}} output parameter type description status code number http status code of the response reason string response reason phrase temporaryattachments array output field temporaryattachments temporaryattachments temporaryattachmentid string unique identifier temporaryattachments filename string name of the resource output example {"status code" 201,"response headers" {"date" "thu, 23 jan 2025 06 00 00 gmt","content type" "application/json;charset=utf 8"},"reason" "created","json body" {"temporaryattachments" \[{},{}]}} create comment with attachment creates a comment with attachments on a jira service desk issue using the specified issue id or key requires prior upload of files to obtain attachment ids endpoint url /rest/servicedeskapi/request/{{issueidorkey}}/attachment method post input argument name type required description path parameters issueidorkey string required the id or key of the customer request to add the comment and attachments to public boolean optional whether the comment and attachments are visible to customers (true) or internal only (false) required temporaryattachmentids array optional list of temporary attachment ids from the attach temporary file action at least one is required to create a comment with attachments additionalcomment object optional optional comment text to include with the attachments additionalcomment body string optional content of the comment input example {"json body" {"public"\ true,"temporaryattachmentids" \["temp8186986881700442965"],"additionalcomment" {"body" "please find the attached document "}},"path parameters" {"issueidorkey" "1000"}} output parameter type description status code number http status code of the response reason string response reason phrase comment object output field comment comment expands array output field comment expands comment id string unique identifier comment body string request body data comment public boolean output field comment public comment author object output field comment author comment author accountid string unique identifier comment author name string name of the resource comment author key string output field comment author key comment author emailaddress string output field comment author emailaddress comment author displayname string name of the resource comment author active boolean output field comment author active comment author timezone string output field comment author timezone comment author links object output field comment author links comment author links jirarest string output field comment author links jirarest comment author links avatarurls object url endpoint for the request comment author links avatarurls 16x16 string url endpoint for the request comment author links avatarurls 24x24 string url endpoint for the request comment author links avatarurls 32x32 string url endpoint for the request comment author links avatarurls 48x48 string url endpoint for the request comment author links self string output field comment author links self comment created object output field comment created comment created epochmillis number output field comment created epochmillis output example {"status code" 201,"response headers" {"date" "thu, 23 jan 2025 06 00 00 gmt","content type" "application/json;charset=utf 8"},"reason" "created","json body" {"comment" {" expands" \[],"id" "1000","body" "please find the screenshot and the log file attached !screenshot png|thumbnail! ","public"\ true,"author" {},"created" {}," links" {}},"attachments" {" expands" \[],"size" 2,"start" 2,"limit" 2,"islastpage"\ false," links" {},"values" \[]}}} create customer request creates a customer request in atlassian jira service desk using specified field values, request type, and service desk id endpoint url /rest/servicedeskapi/request method post input argument name type required description channel string optional (experimental) shows extra information for the request channel form object optional provides answers to the form associated with a request type that is attached to the request on creation jira fields should be omitted from requestfieldvalues if they are linked to form answers form answers in adf format should have isadfrequest set to true form answers are not currently validated form answers object optional parameter for create customer request form answers 1 object optional parameter for create customer request form answers 1 text string optional answer in free text format form answers 2 object optional parameter for create customer request form answers 2 date string optional answer in date format (yyyy mm dd) form answers 3 object optional parameter for create customer request form answers 3 time string optional answer in timestamp format (hh \ mm ) form answers 4 object optional parameter for create customer request form answers 4 choices array optional ids of selected choices form answers 5 object optional parameter for create customer request form answers 5 users array optional ids of selected users form answers 6 object optional parameter for create customer request form answers 6 files array optional the ids of files to be attached to the form that are obtained by calling the ‘attach temporary file’ endpoint on the corresponding service desk form answers 7 object optional parameter for create customer request form answers 7 adf object optional answer in atlassian document format (adf) isadfrequest boolean optional (experimental) whether to accept rich text fields in atlassian document format (adf) requestfieldvalues object optional json map of jira field ids and their values representing the content of the request requestfieldvalues description string optional value for the parameter requestfieldvalues summary string optional value for the parameter requestparticipants array optional list of customers to participate in the request, as a list of account id values requesttypeid string optional id of the request type for the request servicedeskid string optional id of the service desk in which to create the request raiseonbehalfof string optional the account id of the customer that the request is being raised on behalf of input example {"json body" {"channel" "","form" {"answers" {"1" {"text" "answer to a text form field"},"2" {"date" "2023 07 06"},"3" {"time" "14 35"},"4" {"choices" \["5"]},"5" {"users" \["qm\ a713c8ea 1075 4e30 9d96 891a7d181739 5ad6d69abfa3980ce712caae"]},"6" {"files" \[""]},"7" {"adf" {}}}},"isadfrequest"\ false,"requestfieldvalues" {"description" "i need a new mouse for my mac","summary" "request jsd help via rest"},"requestparticipants" \["qm\ a713c8ea 1075 4e30 9d96 891a7d181739 5ad6d69abfa3980ce712caae"],"requesttypeid" "25","servicedeskid" "10","raiseonbehalfof" ""}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands issueid string unique identifier issuekey string output field issuekey summary string output field summary requesttypeid string unique identifier servicedeskid string unique identifier createddate object date value createddate epochmillis number output field createddate epochmillis createddate friendly string output field createddate friendly createddate iso8601 string output field createddate iso8601 createddate jira string output field createddate jira reporter object output field reporter reporter accountid string unique identifier reporter name string name of the resource reporter key string output field reporter key reporter emailaddress string output field reporter emailaddress reporter displayname string name of the resource reporter active boolean output field reporter active reporter timezone string output field reporter timezone reporter links object output field reporter links reporter links jirarest string output field reporter links jirarest reporter links avatarurls object url endpoint for the request reporter links avatarurls 16x16 string url endpoint for the request output example {"status code" 201,"response headers" {"date" "thu, 23 jan 2025 05 50 22 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "99085b24aa18b5d8d7d761bed4c7fde4","set cookie" "atlassian xsrf token=cfb7871d63c024ee0f0ac3d2c176e648753b5ee5 lin; path=/; sames ","x aaccountid" "712020%3a2a1eb012 513a 43ab a951 289a3bd45b64","cache control" "no store","location" "https //mohanaa013 atlassian net/rest/servicedeskapi/request/10012","var create request comment creates a public or private comment on a jira service desk request, with visibility determined by the 'public' parameter endpoint url /rest/servicedeskapi/request/{{issueidorkey}}/comment method post input argument name type required description path parameters issueidorkey string required the id or key of the customer request to which the comment will be added body string optional content of the comment public boolean optional indicates whether the comment is public (true) or private/internal (false) input example {"json body" {"body" "hello there","public"\ true},"path parameters" {"issueidorkey" "1000"}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands id string unique identifier body string request body data public boolean output field public author object output field author author accountid string unique identifier author name string name of the resource author key string output field author key author emailaddress string output field author emailaddress author displayname string name of the resource author active boolean output field author active author timezone string output field author timezone author links object output field author links author links jirarest string output field author links jirarest author links avatarurls object url endpoint for the request author links avatarurls 16x16 string url endpoint for the request author links avatarurls 24x24 string url endpoint for the request author links avatarurls 32x32 string url endpoint for the request author links avatarurls 48x48 string url endpoint for the request author links self string output field author links self created object output field created created epochmillis number output field created epochmillis created friendly string output field created friendly output example {"status code" 201,"response headers" {"date" "thu, 23 jan 2025 05 54 01 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "4e65f9e25b291897f5888ca3ca6cdfdf","set cookie" "atlassian xsrf token=7e2e7b4d2ae76d0ed5ce27b8d1ec12afceb2735b lin; path=/; sames ","x aaccountid" "712020%3a2a1eb012 513a 43ab a951 289a3bd45b64","cache control" "no store","location" "https //mohanaa013 atlassian net/rest/servicedeskapi/request/10012/comme get customer request by id or key retrieve a specific customer request from atlassian jira service desk using the unique issue id or key endpoint url /rest/servicedeskapi/request/{{issueidorkey}} method get input argument name type required description path parameters issueidorkey string required the id or key of the customer request to be returned parameters expand array optional a multi value parameter indicating which properties of the customer request to expand, where servicedesk returns additional service desk details requesttype returns additional customer request type details participant returns the participant details sla returns the sla information status returns the status transitions, in chronological order attachment returns the attachments action returns the actions that the user can or cannot perform comment returns the comments comment attachment returns the attachment details for each comment comment renderedbody (experimental) return the rendered body in html format (in addition to the raw body) for each comment input example {"parameters" {"expand" \["servicedesk","participant"]},"path parameters" {"issueidorkey" "107001"}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands issueid string unique identifier issuekey string output field issuekey summary string output field summary requesttypeid string unique identifier servicedeskid string unique identifier createddate object date value createddate epochmillis number output field createddate epochmillis createddate friendly string output field createddate friendly createddate iso8601 string output field createddate iso8601 createddate jira string output field createddate jira reporter object output field reporter reporter accountid string unique identifier reporter name string name of the resource reporter key string output field reporter key reporter emailaddress string output field reporter emailaddress reporter displayname string name of the resource reporter active boolean output field reporter active reporter timezone string output field reporter timezone reporter links object output field reporter links reporter links jirarest string output field reporter links jirarest reporter links avatarurls object url endpoint for the request reporter links avatarurls 16x16 string url endpoint for the request output example {"status code" 200,"response headers" {"date" "thu, 23 jan 2025 06 02 25 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "c7930753a06255d9aa275623b482b79e","set cookie" "atlassian xsrf token=1381bd89b71fd09e1fd51dd9f115f2b6183dd06d lin; path=/; sames ","x aaccountid" "712020%3a2a1eb012 513a 43ab a951 289a3bd45b64","cache control" "no store","vary" "accept encoding","content encoding" "gzip","x content type options" "nosniff get customer requests retrieves all customer requests for the querying user from atlassian jira service desk, ordered by recent activity endpoint url /rest/servicedeskapi/request method get input argument name type required description parameters searchterm string optional filters customer requests where the request summary matches the searchterm wildcards can be used in the searchterm parameter parameters requestownership array optional filters customer requests using the following values owned requests returns customer requests where the user is the creator participated requests returns customer requests where the user is a participant organization returns customer requests for an organization of which the user is a member when used in conjunction with organization id all organizations returns customer requests that belong to all organizations of which the user is a member approver returns customer requests where the user is an approver can be used in conjunction with approvalstatus to filter pending or complete approvals all requests returns all customer requests deprecated and will be removed, as the returned requests may change if more values are added in the future instead, explicitly list the desired filtering strategies multiple values of the query parameter are supported if not specified, filtering defaults to owned requests, participated requests, and all organizations parameters requeststatus string optional filters customer requests where the request is closed, open, or either of the two where closed requests returns customer requests that are closed open requests returns customer requests that are open all requests returns all customer requests parameters approvalstatus string optional filters results to customer requests based on their approval status my pending approval returns customer requests pending the user's approval my history approval returns customer requests where the user was an approver valid only when used with requestownership=approver parameters organizationid number optional filters customer requests that belong to a specific organization (note that the user must be a member of that organization) note valid only when used with requestownership=organization parameters servicedeskid number optional filters customer requests by service desk parameters requesttypeid number optional filters customer requests by request type note that the service desk id must be specified for the service desk in which the request type belongs parameters expand array optional a multi value parameter indicating which properties of the customer request to expand, where servicedesk returns additional details for each service desk requesttype returns additional details for each request type participant returns the participant details, if any, for each customer request sla returns the sla information on each customer request status returns the status transitions, in chronological order, for each customer request attachment returns the attachments for the customer request action returns the actions that the user can or cannot perform on this customer request comment returns the comments, if any, for each customer request comment attachment returns the attachment details, if any, for each comment comment renderedbody (experimental) returns the rendered body in html format (in addition to the raw body) for each comment parameters start number optional the starting index of the returned objects base index 0 see the pagination section for more details parameters limit number optional the maximum number of items to return per page default is 50 see the pagination section for more details input example {"parameters" {"searchterm" "jira software","requestownership" \["owned requests","participated requests","all organizations"],"requeststatus" "closed requests","approvalstatus" "my pending approval","organizationid" 1,"servicedeskid" 2,"requesttypeid" 3,"expand" \["servicedesk","participant"],"start" 0,"limit" 50}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands size number output field size start number output field start limit number output field limit islastpage boolean output field islastpage links object output field links links base string output field links base links context string output field links context links next string output field links next links prev string output field links prev values array value for the parameter values expands array value for the parameter values issueid string unique identifier values issuekey string value for the parameter values summary string value for the parameter values requesttypeid string unique identifier values servicedeskid string unique identifier values createddate object value for the parameter values createddate epochmillis number value for the parameter values createddate friendly string value for the parameter values createddate iso8601 string value for the parameter values createddate jira string value for the parameter values reporter object value for the parameter output example {" expands" \["string"],"size" 123,"start" 123,"limit" 123,"islastpage"\ true," links" {"base" "string","context" "string","next" "string","prev" "string"},"values" \[{" expands" \[],"issueid" "string","issuekey" "string","summary" "string","requesttypeid" "string","servicedeskid" "string","createddate" {},"reporter" {},"requestfieldvalues" \[],"currentstatus" {}," links" {}}]} get request comment by id retrieve details for a specific comment on a customer request in atlassian jira service desk using the issue and comment ids endpoint url /rest/servicedeskapi/request/{{issueidorkey}}/comment/{{commentid}} method get input argument name type required description path parameters issueidorkey string required the id or key of the customer request that contains the comment path parameters commentid string required the id of the comment to retrieve parameters expand array optional a multi value parameter indicating which properties of the comment to expand attachment returns the attachment details, if any, for the comment (if you want to get all attachments for a request, use servicedeskapi/request/{issueidorkey}/attachment ) renderedbody (experimental) returns the rendered body in html format (in addition to the raw body) of the comment input example {"parameters" {"expand" \["attachment","renderedbody"]},"path parameters" {"issueidorkey" "1000","commentid" "1001"}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands id string unique identifier body string request body data public boolean output field public author object output field author author accountid string unique identifier author name string name of the resource author key string output field author key author emailaddress string output field author emailaddress author displayname string name of the resource author active boolean output field author active author timezone string output field author timezone author links object output field author links author links jirarest string output field author links jirarest author links avatarurls object url endpoint for the request author links avatarurls 16x16 string url endpoint for the request author links avatarurls 24x24 string url endpoint for the request author links avatarurls 32x32 string url endpoint for the request author links avatarurls 48x48 string url endpoint for the request author links self string output field author links self created object output field created created epochmillis number output field created epochmillis created friendly string output field created friendly output example {"status code" 200,"response headers" {"date" "thu, 23 jan 2025 06 09 57 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "443db82510413900e3047c5098a3150a","set cookie" "atlassian xsrf token=548322216ae2cd0de19dd5f6f20606d699c5c645 lin; path=/; sames ","x aaccountid" "712020%3a2a1eb012 513a 43ab a951 289a3bd45b64","cache control" "no store","vary" "accept encoding","content encoding" "gzip","x content type options" "nosniff get request comments retrieve all comments from a specific customer request in atlassian jira service desk using the issueidorkey parameter endpoint url /rest/servicedeskapi/request/{{issueidorkey}}/comment method get input argument name type required description path parameters issueidorkey string required the id or key of the customer request whose comments will be retrieved parameters public boolean optional specifies whether to return public comments or not default is true parameters internal boolean optional specifies whether to return internal comments or not default is true parameters expand array optional a multi value parameter indicating which properties of the comment to expand attachment returns the attachment details, if any, for each comment (if you want to get all attachments for a request, use servicedeskapi/request/{issueidorkey}/attachment ) renderedbody (experimental) returns the rendered body in html format (in addition to the raw body) for each comment parameters start number optional the starting index of the returned comments base index 0 see the pagination section for more details parameters limit number optional the maximum number of comments to return per page default 50 see the pagination section for more details input example {"parameters" {"public"\ true,"internal"\ true,"expand" \["attachment","renderedbody"],"start" 0,"limit" 50},"path parameters" {"issueidorkey" "107001"}} output parameter type description status code number http status code of the response reason string response reason phrase expands array output field expands size number output field size start number output field start limit number output field limit islastpage boolean output field islastpage links object output field links links base string output field links base links context string output field links context links next string output field links next links prev string output field links prev values array value for the parameter values expands array value for the parameter values id string unique identifier values body string request body data values public boolean value for the parameter values author object value for the parameter values author accountid string unique identifier values author name string name of the resource values author key string value for the parameter values author emailaddress string value for the parameter values author displayname string name of the resource values author active boolean value for the parameter values author timezone string value for the parameter output example {"status code" 200,"response headers" {"date" "thu, 23 jan 2025 06 05 49 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "15f361768cf7bb198c5db2c46216660a","set cookie" "atlassian xsrf token=060516bd66e1174b79395e9f58cc241c5be1e684 lin; path=/; sames ","x aaccountid" "712020%3a2a1eb012 513a 43ab a951 289a3bd45b64","cache control" "no store","vary" "accept encoding","content encoding" "gzip","x content type options" "nosniff perform customer transition executes a customer transition for a jira service desk request using the issue id or key and transition id endpoint url /rest/servicedeskapi/request/{{issueidorkey}}/transition method post input argument name type required description path parameters issueidorkey string required the id or key of the customer request to transition id string optional the id of the transition to perform obtain available transitions via get /rest/servicedeskapi/request/{issueidorkey}/transition additionalcomment object optional optional comment explaining the reason for the transition additionalcomment body string optional content of the comment input example {"json body" {"id" "31","additionalcomment" {"body" "resolved by support team "}},"path parameters" {"issueidorkey" "1000"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 204,"response headers" {"date" "thu, 23 jan 2025 06 00 00 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge"},"reason" "no content"} response headers header description example atl request id http response header atl request id cbfbe1a9 113f 42a4 b5a1 bb7821b93a0b atl traceid http response header atl traceid cbfbe1a9113f42a4b5a1bb7821b93a0b cache control directives for caching mechanisms no store content encoding http response header content encoding gzip content type the media type of the resource application/json;charset=utf 8 date the date and time at which the message was originated thu, 23 jan 2025 06 09 57 gmt location the url to redirect a page to https //mohanaa013 atlassian net/rest/servicedeskapi/request/10012/comment/10004 nel http response header nel {"failure fraction" 0 001, "include subdomains" true, "max age" 600, "report to" "endpoint 1"} report to http response header report to {"endpoints" \[{"url" " https //dz8aopenkvv6s cloudfront net "}], "group" "endpoint 1", "include subdomains" true, "max age" 600} server information about the software used by the origin server atlassianedge server timing http response header server timing atl edge;dur=736,atl edge internal;dur=356,atl edge upstream;dur=332,atl edge pop;desc="aws ap south 1" set cookie http response header set cookie atlassian xsrf token=cfb7871d63c024ee0f0ac3d2c176e648753b5ee5 lin; path=/; samesite=none; secure strict transport security http response header strict transport security max age=63072000; includesubdomains; preload timing allow origin http response header timing allow origin transfer encoding http response header transfer encoding chunked vary http response header vary accept encoding x aaccountid http response header x aaccountid 712020%3a2a1eb012 513a 43ab a951 289a3bd45b64 x arequestid http response header x arequestid 99085b24aa18b5d8d7d761bed4c7fde4 x content type options http response header x content type options nosniff x xss protection http response header x xss protection 1; mode=block