Atlassian Jira Service Desk

the atlassian jira service desk connector enables streamlined interaction with jira service desk for issue tracking and service management directly through the swimlane platform atlassian jira service desk is a versatile platform for managing it service requests and incident reporting this connector allows swimlane turbine users to create, update, and manage jira service desk customer requests directly within the swimlane ecosystem by integrating with jira service desk, users can automate ticket creation, comment management, and request tracking, streamlining the incident response process and enhancing collaboration between it support and security teams the connector's actions enable seamless communication with jira's api, providing a powerful tool for incident management and resolution 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 in swimlane turbine, ensure you have the following bearer token authentication with the following parameters url the base url for your jira service desk instance access token a valid access token for authenticating api requests basic authentication with the following parameters 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 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 get customer request by id or key get customer requests get request comment by id get request comments 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 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 create customer request this method creates a customer request in a service desk 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 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 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 this method returns a customer request 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 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 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 this method returns details of a customer request's comment 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 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 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 response headers header description example atl request id http response header atl request id eba53e40 bb07 4481 8a3f 906c216a2054 atl traceid http response header atl traceid 6935131bb690493bb3c1520eb2b6cb86 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 05 49 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=379,atl edge internal;dur=16,atl edge upstream;dur=364,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 859784d3ebaebaad33de36e2e0d6b9f7 x content type options http response header x content type options nosniff x xss protection http response header x xss protection 1; mode=block