Atlassian Jira

the atlassian jira connector facilitates the integration of jira's issue and project tracking capabilities with automated workflows in the swimlane platform atlassian jira is a widely used platform for issue tracking and project management the atlassian jira turbine connector enables seamless integration with swimlane turbine, allowing users to automate issue creation, management, and reporting directly within the security automation workflows by leveraging this connector, security teams can streamline incident response, enhance collaboration, and maintain a centralized system for tracking security issues and tasks prerequisites to utilize the atlassian jira connector within swimlane turbine, ensure you have the following prerequisites custom authentication with access token or client credentials url the base url of your jira instance (e g , https //your domain atlassian net ) http basic authentication using username and api token url the base url of your jira instance username your jira username api token a jira api token generated from your atlassian account http bearer token authentication url the base url of your jira instance access token a valid oauth access token for jira capabilities the atlassian jira connector has the following capabilities add attachment add comment assign issue convert rich text to adf create issue delete attachment delete comment delete issue find users assignable to issues find users assignable to projects find users for picker find users keys by query find users by query find users with browse permission find users with permissions and so on additional information in the case of using the create issue action, please check the following urls for the issuetype id , project key id and other related inputs https //confluence atlassian com/jirakb/finding the id for issue types 646186508 html https //confluence atlassian com/jirakb/how to get project id from the jira user interface 827341414 html https //confluence atlassian com/adminjiraserver/jira oauth 2 0 provider api 1115659070 html the swimlane team will provide a python script and instructions on how to use the script to generate the access token and refresh token using oauth2 0 configurations atlassian jira custom authentication atlassian jira custom authentication using access token or client credentials configuration parameters parameter description type required url a url to the target host string required access token the access token string optional client id the client id must correspond to the client id specified in the registered client table string optional client secret the client secret must correspond to the redirect uri specified in the registered client table string optional refresh token the refresh token string optional verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional 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 api token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional http bearer authentication authenticates using bearer token configuration parameters parameter description type required url a url to the target host string required token the access token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions add comment adds a comment to a jira issue identified by the unique issueidorkey endpoint url /rest/api/3/issue/{{issueidorkey}}/comment method post input argument name type required description path parameters issueidorkey string required parameters for the add comment action parameters expand string optional use expand to include additional information in the response this parameter accepts renderedbody, which returns the comment body rendered in html input example {"parameters" {"expand" "renderedbody"},"path parameters" {"issueidorkey" "sct 214"}} output parameter type description status code number http status code of the response reason string response reason phrase self string output field self id string unique identifier author object output field author author self string output field author self author accountid string unique identifier author emailaddress string output field author emailaddress author avatarurls object url endpoint for the request author avatarurls 48x48 string url endpoint for the request author avatarurls 24x24 string url endpoint for the request author avatarurls 16x16 string url endpoint for the request author avatarurls 32x32 string url endpoint for the request author displayname string name of the resource author active boolean output field author active author timezone string output field author timezone author accounttype string type of the resource body object request body data body type string request body data body version number request body data body content array request body data body content type string request body data body content content array request body data body content content type string request body data body content content text string request body data output example {"self" "string","id" "12345678 1234 1234 1234 123456789abc","author" {"self" "string","accountid" "string","emailaddress" "string","avatarurls" {"48x48" "string","24x24" "string","16x16" "string","32x32" "string"},"displayname" "example name","active"\ true,"timezone" "string","accounttype" "string"},"body" {"type" "string","version" 123,"content" \[{}]},"updateauthor" {"self" "string","accountid" "string","emailaddress" "string","avatarurls" {"48x48" "string","24x24" "string","16x16" "string","3 assign issue assigns a specified jira issue to a user, ensuring the user has the required project permissions endpoint url /rest/api/3/issue/{{issueidorkey}}/assignee method put input argument name type required description path parameters issueidorkey string required the id or key of the issue to assign accountid string optional the account id of the user to assign the issue to use 1 to unassign the issue max length is 128 name string optional the name of the user to assign the issue to key string optional the key of the user to assign the issue to input example {"json body" {"accountid" "5b10a2844c20165700ede21g"},"path parameters" {"issueidorkey" "proj 123"}} output parameter type description status code number http status code of the response reason string response reason phrase accountid string unique identifier displayname string name of the resource emailaddress string output field emailaddress active boolean output field active timezone string output field timezone accounttype string type of the resource avatarurls object url endpoint for the request avatarurls 16x16 string url endpoint for the request avatarurls 24x24 string url endpoint for the request avatarurls 32x32 string url endpoint for the request avatarurls 48x48 string url endpoint for the request output example {"accountid" "string","displayname" "example name","emailaddress" "string","active"\ true,"timezone" "string","accounttype" "string","avatarurls" {"16x16" "string","24x24" "string","32x32" "string","48x48" "string"}} add attachment adds an attachment to a jira issue identified by issueidorkey, with required path parameters and headers endpoint url /rest/api/3/issue/{{issueidorkey}}/attachments method post input argument name type required description attachments array required attachment to add attachments file string optional parameter for add attachment attachments file name string optional name of the resource path parameters issueidorkey string required parameters for the add attachment action headers object required http headers for the request headers x atlassian token string required http headers for the request input example {"path parameters" {"issueidorkey" "sct 216"},"headers" {"x atlassian token" "no check"}} output parameter type description status code number http status code of the response reason string response reason phrase output example \[] delete attachment removes a specified attachment from an issue in atlassian jira using the unique attachment id endpoint url /rest/api/3/attachment/{{id}} method delete input argument name type required description path parameters id string required parameters for the delete attachment action headers object required http headers for the request headers x atlassian token string required http headers for the request input example {"path parameters" {"id" "64327"},"headers" {"x atlassian token" "no check"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"response text" "string"} convert rich text to adf converts rich text to atlassian document format (adf) to ensure compatibility with jira applications input argument name type required description rich text object optional parameter for convert rich text to adf rich text summary string optional parameter for convert rich text to adf input example {"rich text" {"summary" "\<p>this is a test \<br />\<strong>this is a test \<br />\</strong>\<em>this is a test \</em>\<strong>\<br />\</strong>\<span style=\\"color #f1c40f;\\">this is a test \<br />\</span>\</p>\n\<p>\<span style=\\"color #e03e2d;\\">this is a test \</span>\</p>"}} output parameter type description summary object output field summary summary version number output field summary version summary type string type of the resource summary content array response content summary content type string type of the resource summary content content array response content summary content content type string type of the resource summary content content text string response content summary content content marks array response content summary content content marks type string type of the resource summary content content marks attrs object response content title object output field title title version number output field title version title type string type of the resource title content array response content title content type string type of the resource title content content array response content title content content type string type of the resource title content content text string response content gen object output field gen gen version number output field gen version gen type string type of the resource gen content array response content gen content file name string name of the resource gen content file string response content output example {"summary" {"version" 1,"type" "doc","content" \[{},{}]},"title" {"version" 1,"type" "doc","content" \[{}]},"gen" {"version" 1,"type" "doc","content" \[]},"p1" {"version" 1,"type" "doc","content" \[{},{},{}]},"p2" {"version" 1,"type" "doc","content" \[{},{},{}]},"p3" {"version" 1,"type" "doc","content" \[{}]}} delete comment removes a specified comment from an issue in atlassian jira using the provided issue and comment ids endpoint url /rest/api/3/issue/{{issueidorkey}}/comment/{{id}} method delete input argument name type required description path parameters issueidorkey string required the id or key of the issue path parameters id string required the id of the comment input example {"path parameters" {"issueidorkey" "proj 123","id" 10001}} output parameter type description status code number http status code of the response reason string response reason phrase errormessages array response message errors object error message if any output example {"errormessages" \["string"],"errors" {}} delete issue deletes a specified jira issue by issueidorkey; requires prior deletion of any subtasks endpoint url /rest/api/3/issue/{{issueidorkey}} method delete input argument name type required description path parameters issueidorkey string required the id or key of the issue to delete parameters deletesubtasks string optional whether the issue's subtasks are deleted when the issue is deleted input example {"parameters" {"deletesubtasks"\ false},"path parameters" {"issueidorkey" "proj 123"}} output parameter type description status code number http status code of the response reason string response reason phrase errormessages array response message errors object error message if any output example {"errormessages" \["string"],"errors" {}} find users retrieve up to 50 atlassian jira users matching the search term endpoint url /rest/api/3/user/search method get input argument name type required description parameters query string optional a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com required, unless username is specified parameters username string optional this parameter is no longer available and will be removed from the documentation soon use query instead parameters accountid string optional a query string that is matched exactly against user account id required, unless query is specified parameters property string optional a query string used to search properties property keys are specified by path, so properties which are not direct properties of the returned objects should not be matched for example, if value is returned by a property called something nested property, then the request should include something nested as the property if the property is an array, then the request should include something nested\[] as the property parameters maxresults number optional the maximum number of items to return per page parameters startat number optional the index of the first item to return in a page of results (page offset) input example {"parameters" {"query" "john","maxresults" 50,"startat" 0}} output parameter type description status code number http status code of the response reason string response reason phrase output example \[] find users assignable to issues retrieve a list of users eligible for issue assignment in atlassian jira, aiding in efficient task delegation endpoint url /rest/api/3/user/assignable/search method get input argument name type required description parameters query string optional a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters sessionid string optional the id of the session parameters accountid string optional a query string that is matched exactly against user account id required, unless query is specified parameters project string optional the key of the project parameters issuekey string optional the key of the issue parameters issueid string optional the id of the issue parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page parameters actiondescriptorid number optional the id of the action descriptor parameters recommend boolean optional whether to recommend users input example {"parameters" {"query" "john","sessionid" "example session id 123","username" "deprecated user name","accountid" "5b10a2844c20165700ede21g","project" "ex","issuekey" "ex 1","issueid" "10001","startat" 0,"maxresults" 50,"actiondescriptorid" 21,"recommend"\ false}} output parameter type description status code number http status code of the response reason string response reason phrase accountid string unique identifier accounttype string type of the resource active boolean output field active applicationroles object output field applicationroles applicationroles items array output field applicationroles items applicationroles items file name string name of the resource applicationroles items file string output field applicationroles items file applicationroles size number output field applicationroles size avatarurls object url endpoint for the request avatarurls 16x16 string url endpoint for the request avatarurls 24x24 string url endpoint for the request avatarurls 32x32 string url endpoint for the request avatarurls 48x48 string url endpoint for the request displayname string name of the resource emailaddress string output field emailaddress groups object output field groups groups items array output field groups items groups items file name string name of the resource groups items file string output field groups items file groups size number output field groups size key string output field key name string name of the resource self string output field self output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"accountid" "5b10a2844c20165700ede21g","accounttype" "atlassian","active"\ true,"applicationroles" {"items" \[],"size" 1},"avatarurls" {"16x16" "https //avatar management avatars server location prod public atl paas net/init ","24x24" "https //avatar management avatars server location prod public atl paas net/init ","32x32" "https //avatar management avatars server location prod public atl paas net/init ","48x48" "https / find users assignable to projects retrieves a list of users eligible for issue assignment in specified projects, with optional attribute matching endpoint url /rest/api/3/user/assignable/multiprojectsearch method get input argument name type required description parameters query string optional a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters projectkeys string required a list of project keys (case sensitive) this parameter accepts a comma separated list parameters accountid string optional a query string that is matched exactly against user account id required, unless query is specified parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"query" "john","projectkeys" "ex,test","startat" 0,"maxresults" 50}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"accountid" "5b10a2844c20165700ede21g","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "mia krystof","key" "","name" "","self" "https //your domain atlassian net/rest/api/3/user?accountid=5b10a2844c20165700ed "},{"accountid" "5b10ac8d82e05b22cc7d4ef5","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "emma richards","key" "","name" "","self" "https //your domain atlassian net/rest/a find users for picker retrieves a list of atlassian jira users matching the query term, highlighting matches with html strong tag endpoint url /rest/api/3/user/picker method get input argument name type required description parameters query string required a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters maxresults number optional the maximum number of items to return the total number of matched users is returned in total parameters showavatar boolean optional whether to include the avatar url in the response parameters excludeaccountids array optional a list of account ids to exclude from the search results this parameter accepts a comma separated list parameters avatarsize string optional the size of the avatar to return parameters excludeconnectusers boolean optional whether to exclude users from connect apps from the search results input example {"parameters" {"query" "john","maxresults" 50,"showavatar"\ true,"excludeaccountids" \["5b10a2844c20165700ede21g","5b10a0effa615349cb016cd8","5b10ac8d82e05b22cc7d4ef5"],"avatarsize" "xlarge","excludeconnectusers"\ false}} output parameter type description status code number http status code of the response reason string response reason phrase header string output field header total number output field total users array output field users users accountid string unique identifier users accounttype string type of the resource users avatarurl string url endpoint for the request users displayname string name of the resource users html string output field users html users key string output field users key users name string name of the resource output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"header" "showing 20 of 25 matching groups","total" 25,"users" \[{}]}} find users keys by query retrieves a paginated list of user keys from atlassian jira based on a structured query provided as input endpoint url /rest/api/3/user/search/query/key method get input argument name type required description parameters query string required a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"query" "search text","startat" 0,"maxresults" 100}} output parameter type description status code number http status code of the response reason string response reason phrase islast boolean output field islast maxresults number result of the operation nextpage string output field nextpage self string output field self startat number output field startat total number output field total values array value for the parameter values accountid string unique identifier values key string value for the parameter output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"islast"\ true,"maxresults" 51,"nextpage" "\<string>","self" "\<string>","startat" 37,"total" 29,"values" \[{}]}} find users by query retrieve up to 50 atlassian jira users matching a specified search query using the 'query' parameter endpoint url /rest/api/3/user/search/query method get input argument name type required description parameters query string required a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters maxresults number optional the maximum number of items to return per page parameters startat number optional the index of the first item to return in a page of results (page offset) input example {"parameters" {"query" "john","maxresults" 50,"startat" 0}} output parameter type description status code number http status code of the response reason string response reason phrase self string output field self maxresults number result of the operation startat number output field startat total number output field total islast boolean output field islast nextpage string output field nextpage values array value for the parameter values accountid string unique identifier values accounttype string type of the resource values active boolean value for the parameter values applicationroles object value for the parameter values applicationroles callback object value for the parameter values applicationroles items array value for the parameter values applicationroles max results number value for the parameter values applicationroles pagingcallback object value for the parameter values applicationroles size number value for the parameter values avatarurls object url endpoint for the request values avatarurls 16x16 string url endpoint for the request values avatarurls 24x24 string url endpoint for the request values avatarurls 32x32 string url endpoint for the request values avatarurls 48x48 string url endpoint for the request values displayname string name of the resource values emailaddress string value for the parameter output example {"self" "string","maxresults" 123,"startat" 123,"total" 123,"islast"\ true,"nextpage" "string","values" \[{"accountid" "string","accounttype" "string","active"\ true,"applicationroles" {},"avatarurls" {},"displayname" "example name","emailaddress" "string","expand" "string","groups" {},"key" "string","locale" "string","name" "example name","self" "string","timezone" "string"}]} find users with browse permission retrieves a list of users matching a search string who have permission to browse issues in atlassian jira endpoint url /rest/api/3/user/viewissue/search method get input argument name type required description parameters query string required a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters accountid string optional a query string that is matched exactly against user account id required, unless query is specified parameters issuekey string optional the key of the issue parameters projectkey string optional the key of the project parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"query" "john","username" "deprecated user name","accountid" "5b10a2844c20165700ede21g","issuekey" "ex 1","projectkey" "ex","startat" 0,"maxresults" 50}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"accountid" "5b10a2844c20165700ede21g","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "mia krystof","key" "","name" "","self" "https //your domain atlassian net/rest/api/3/user?accountid=5b10a2844c20165700ed "},{"accountid" "5b10ac8d82e05b22cc7d4ef5","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "emma richards","key" "","name" "","self" "https //your domain atlassian net/rest/a find users with permissions retrieves a list of atlassian jira users matching a search string and possessing specified permissions for projects or issues endpoint url /rest/api/3/user/permission/search method get input argument name type required description parameters query string optional a query string that is matched against user attributes (displayname, and emailaddress) to find relevant users the string can match the prefix of the attribute's value for example, query=john matches a user with a displayname of john smith and a user with an emailaddress of mailto\ johnson\@example com parameters accountid string optional a query string that is matched exactly against user account id required, unless query is specified parameters permissions string required a comma separated list of permissions parameters issuekey string optional the key of the issue parameters projectkey string optional the key of the project parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"query" "john","username" "deprecated user name","accountid" "5b10a2844c20165700ede21g","permissions" "browse,edit issue","issuekey" "ex 1","projectkey" "ex","startat" 0,"maxresults" 50}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"accountid" "5b10a2844c20165700ede21g","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "mia krystof","key" "","name" "","self" "https //your domain atlassian net/rest/api/3/user?accountid=5b10a2844c20165700ed "},{"accountid" "5b10ac8d82e05b22cc7d4ef5","accounttype" "atlassian","active"\ false,"avatarurls" {},"displayname" "emma richards","key" "","name" "","self" "https //your domain atlassian net/rest/a get all users default retrieve a comprehensive list of all users, including active, inactive, and deleted accounts in atlassian jira endpoint url /rest/api/3/users method get input argument name type required description parameters startat number optional the index of the first item to return parameters maxresults number optional the maximum number of items to return input example {"parameters" {"startat" 0,"maxresults" 50}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"date" "thu, 09 jan 2025 10 07 44 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "45c9fb52879c4b3eb540cd8c9fb94205","set cookie" "atlassian xsrf token=5b8d9da0169a025c9f394f0e4434c12aa4e646d5 lin; path=/; sames ","x aaccountid" "5d07f57ceec00a0bcb5eca63","cache control" "no cache, no store, no transform","vary" "accept encoding","content encoding" "gzip","x content type options" "nosn get attachment content retrieve metadata, such as filename and content type, for a specific attachment in atlassian jira using its id endpoint url /rest/api/3/attachment/content/{{id}} method get input argument name type required description path parameters id string required the id of the attachment parameters redirect boolean optional whether to redirect to the attachment input example {"path parameters" {"id" 10001}} output parameter type description status code number http status code of the response reason string response reason phrase filename string name of the resource mimetype string type of the resource size number output field size output example {"filename" "example name","mimetype" "string","size" 123} get attachment metadata retrieves metadata for a specified attachment in atlassian jira using the provided attachment id endpoint url /rest/api/3/attachment/{{id}} method get input argument name type required description path parameters id string required the id of the attachment input example {"path parameters" {"id" 10001}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier self string output field self filename string name of the resource author object output field author author self string output field author self author accountid string unique identifier author accounttype string type of the resource author active boolean output field author active author avatarurls object url endpoint for the request author avatarurls 16x16 string url endpoint for the request author avatarurls 24x24 string url endpoint for the request author avatarurls 32x32 string url endpoint for the request author avatarurls 48x48 string url endpoint for the request author displayname string name of the resource author key string output field author key author name string name of the resource created string output field created size number output field size mimetype string type of the resource content string response content thumbnail string output field thumbnail output example {"id" "12345678 1234 1234 1234 123456789abc","self" "string","filename" "example name","author" {"self" "string","accountid" "string","accounttype" "string","active"\ true,"avatarurls" {"16x16" "string","24x24" "string","32x32" "string","48x48" "string"},"displayname" "example name","key" "string","name" "example name"},"created" "2024 01 01t00 00 00z","size" 123,"mimetype" "string","content" "string","thumbnail" "string"} get jira attachment settings retrieve attachment configurations in atlassian jira, including enablement status and size limits endpoint url /rest/api/3/attachment/meta method get output parameter type description status code number http status code of the response reason string response reason phrase enabled boolean output field enabled uploadlimit number output field uploadlimit output example {"enabled"\ true,"uploadlimit" 123} get changelogs retrieve a sorted, paginated list of changelogs for a given issue in atlassian jira, using the issueidorkey endpoint url /rest/api/3/issue/{{issueidorkey}}/changelog method get input argument name type required description path parameters issueidorkey string required the id or key of the issue parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"startat" 0,"maxresults" 50},"path parameters" {"issueidorkey" "proj 123"}} output parameter type description status code number http status code of the response reason string response reason phrase startat number output field startat maxresults number result of the operation total number output field total islast boolean output field islast nextpage string output field nextpage self string output field self values array value for the parameter values id string unique identifier values author object value for the parameter values author self string value for the parameter values author accountid string unique identifier values author active boolean value for the parameter values author avatarurls object url endpoint for the request values author avatarurls 16x16 string url endpoint for the request values author avatarurls 24x24 string url endpoint for the request values author avatarurls 32x32 string url endpoint for the request values author avatarurls 48x48 string url endpoint for the request values author displayname string name of the resource values author emailaddress string value for the parameter values author timezone string value for the parameter values created string value for the parameter values items array value for the parameter values items field string value for the parameter output example {"startat" 123,"maxresults" 123,"total" 123,"islast"\ true,"nextpage" "string","self" "string","values" \[{"id" "12345678 1234 1234 1234 123456789abc","author" {},"created" "2024 01 01t00 00 00z","items" \[]}]} get comment retrieves a specific comment from an issue in atlassian jira using the provided issue id or key and comment id endpoint url /rest/api/3/issue/{{issueidorkey}}/comment/{{id}} method get input argument name type required description path parameters issueidorkey string required the id or key of the issue path parameters id string required the id of the comment parameters expand string optional use expand to include additional information in the response this parameter accepts renderedbody, which returns the comment body rendered in html input example {"parameters" {"expand" "renderedbody"},"path parameters" {"issueidorkey" "proj 123","id" 10001}} output parameter type description status code number http status code of the response reason string response reason phrase self string output field self id string unique identifier author object output field author author self string output field author self author accountid string unique identifier author active boolean output field author active author displayname string name of the resource body object request body data body type string request body data body version number request body data body content array request body data body content type string request body data body content content array request body data body content content type string request body data body content content text string request body data created string output field created updated string output field updated updateauthor object output field updateauthor updateauthor self string output field updateauthor self updateauthor accountid string unique identifier updateauthor active boolean output field updateauthor active updateauthor displayname string name of the resource visibility object output field visibility output example {"self" "string","id" "12345678 1234 1234 1234 123456789abc","author" {"self" "string","accountid" "string","active"\ true,"displayname" "example name"},"body" {"type" "string","version" 123,"content" \[{}]},"created" "2024 01 01t00 00 00z","updated" "2024 01 01t00 00 00z","updateauthor" {"self" "string","accountid" "string","active"\ true,"displayname" "example name"},"visibility" {"identifier" "string","type" "string","value" "string"}} get comments retrieves all comments from a specified jira issue, optionally ordered by creation date, using the issueidorkey endpoint url /rest/api/3/issue/{{issueidorkey}}/comment method get input argument name type required description path parameters issueidorkey string required the id or key of the issue parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page parameters orderby string optional order the results by a particular field parameters expand string optional use expand to include additional information in the response this parameter accepts renderedbody, which returns the comment body rendered in html input example {"parameters" {"startat" 0,"maxresults" 50,"orderby" "created","expand" "renderedbody"},"path parameters" {"issueidorkey" "proj 123"}} output parameter type description status code number http status code of the response reason string response reason phrase startat number output field startat maxresults number result of the operation total number output field total comments array output field comments comments self string output field comments self comments id string unique identifier comments author object output field comments author comments author self string output field comments author self comments author accountid string unique identifier comments author emailaddress string output field comments author emailaddress comments author avatarurls object url endpoint for the request comments author avatarurls 16x16 string url endpoint for the request comments author avatarurls 24x24 string url endpoint for the request comments author avatarurls 32x32 string url endpoint for the request comments author avatarurls 48x48 string url endpoint for the request comments author displayname string name of the resource comments author active boolean output field comments author active comments author timezone string output field comments author timezone comments author accounttype string type of the resource comments body object request body data comments body type string request body data comments body version number request body data comments body content array request body data output example {"startat" 123,"maxresults" 123,"total" 123,"comments" \[{"self" "string","id" "12345678 1234 1234 1234 123456789abc","author" {},"body" {},"updateauthor" {},"created" "2024 01 01t00 00 00z","updated" "2024 01 01t00 00 00z","jsdpublic"\ true}]} get comments by ids fetches a paginated list of comments from atlassian jira using specified comment ids, with optional anonymous access endpoint url /rest/api/3/comment/list method post input argument name type required description parameters expand string optional use expand to include additional information in the response this parameter accepts renderedbody, which returns the comment body rendered in html ids array optional the list of comment ids input example {"parameters" {"expand" "renderedbody"},"json body" {"ids" \[10001,10002,10003]}} output parameter type description status code number http status code of the response reason string response reason phrase startat number output field startat maxresults number result of the operation total number output field total islast boolean output field islast values array value for the parameter values self string value for the parameter values id string unique identifier values author object value for the parameter values author self string value for the parameter values author accountid string unique identifier values author active boolean value for the parameter values author displayname string name of the resource values body object request body data values body type string request body data values body version number request body data values body content array request body data values body content type string request body data values body content content array request body data values body content content type string request body data values body content content text string request body data values created string value for the parameter values updated string value for the parameter values updateauthor object value for the parameter output example {"startat" 123,"maxresults" 123,"total" 123,"islast"\ true,"values" \[{"self" "string","id" "12345678 1234 1234 1234 123456789abc","author" {},"body" {},"created" "2024 01 01t00 00 00z","updated" "2024 01 01t00 00 00z","updateauthor" {},"visibility" {}}]} get fields retrieves all system and custom issue fields available in atlassian jira, providing a comprehensive field list endpoint url /rest/api/3/field method get output parameter type description status code number http status code of the response reason string response reason phrase output example \[] get all labels obtain a paginated list of labels from atlassian jira to categorize issues effectively endpoint url /rest/api/3/label method get input argument name type required description parameters startat number optional the index of the first item to return in a page of results (page offset) parameters maxresults number optional the maximum number of items to return per page input example {"parameters" {"startat" 0,"maxresults" 50}} output parameter type description status code number http status code of the response reason string response reason phrase startat number output field startat maxresults number result of the operation total number output field total islast boolean output field islast values array value for the parameter output example {"startat" 123,"maxresults" 123,"total" 123,"islast"\ true,"values" \["string"]} get project retrieve detailed information for a specified project in atlassian jira using the projectidorkey endpoint url /rest/api/3/project/{{projectidorkey}} method get input argument name type required description path parameters projectidorkey string required the project id or project key (case sensitive) parameters expand string optional use expand to include additional information in the response this parameter accepts a comma separated list expand options include description, issuetypes, lead, projectkeys, url, permissions input example {"parameters" {"expand" "description,lead,url","properties" "key,value"},"path parameters" {"projectidorkey" "proj"}} output parameter type description status code number http status code of the response reason string response reason phrase expand string output field expand self string output field self id string unique identifier key string output field key description string output field description lead object output field lead lead self string output field lead self lead accountid string unique identifier lead accounttype string type of the resource lead active boolean output field lead active lead avatarurls object url endpoint for the request lead avatarurls 16x16 string url endpoint for the request lead avatarurls 24x24 string url endpoint for the request lead avatarurls 32x32 string url endpoint for the request lead avatarurls 48x48 string url endpoint for the request lead displayname string name of the resource lead key string output field lead key lead name string name of the resource components array output field components components ari string output field components ari components assignee object output field components assignee components assignee self string output field components assignee self components assignee accountid string unique identifier output example {"expand" "string","self" "string","id" "12345678 1234 1234 1234 123456789abc","key" "string","description" "string","lead" {"self" "string","accountid" "string","accounttype" "string","active"\ true,"avatarurls" {"16x16" "string","24x24" "string","32x32" "string","48x48" "string"},"displayname" "example name","key" "string","name" "example name"},"components" \[{"ari" "string","assignee" {},"assigneetype" "string","description" "string","id" "12345678 1234 1234 1234 123456789abc","isassigneetypev get available transitions retrieve all possible transitions for a specific jira issue based on user permissions and current status, using the issueidorkey endpoint url /rest/api/3/issue/transitions method get input argument name type required description parameters issueidorkey string required the id or key of the issue parameters endingbefore string optional (optional) the end cursor for use in pagination parameters startingafter string optional (optional) the start cursor for use in pagination input example {"parameters" {"issueidorkey" "proj 123"}} output parameter type description status code number http status code of the response reason string response reason phrase availabletransitions array output field availabletransitions availabletransitions istransitionsfiltered boolean output field availabletransitions istransitionsfiltered availabletransitions issues array output field availabletransitions issues availabletransitions transitions array output field availabletransitions transitions availabletransitions transitions to object output field availabletransitions transitions to availabletransitions transitions to statusid number unique identifier availabletransitions transitions to statusname string name of the resource availabletransitions transitions transitionid number unique identifier availabletransitions transitions transitionname string name of the resource output example {"availabletransitions" \[{"istransitionsfiltered"\ true,"issues" \[],"transitions" \[]}]} get user retrieves a user's details from atlassian jira using the provided accountid, while respecting privacy settings endpoint url /rest/api/3/user method get input argument name type required description parameters accountid string required the account id of the user, which uniquely identifies the user across all atlassian products max length is 128 parameters expand string optional use expand to include additional information about users in the response this parameter accepts a comma separated list expand options include groups includes all groups and nested groups to which the user belongs applicationroles includes details of all the applications to which the user has access input example {"parameters" {"accountid" "5b10ac8d82e05b22cc7d4ef5","expand" "groups"}} output parameter type description status code number http status code of the response reason string response reason phrase self string output field self accountid string unique identifier accounttype string type of the resource emailaddress string output field emailaddress avatarurls object url endpoint for the request avatarurls 48x48 string url endpoint for the request avatarurls 24x24 string url endpoint for the request avatarurls 16x16 string url endpoint for the request avatarurls 32x32 string url endpoint for the request displayname string name of the resource active boolean output field active timezone string output field timezone locale string output field locale groups object output field groups groups size number output field groups size groups items array output field groups items groups items file name string name of the resource groups items file string output field groups items file applicationroles object output field applicationroles applicationroles size number output field applicationroles size applicationroles items array output field applicationroles items applicationroles items file name string name of the resource applicationroles items file string output field applicationroles items file output example {"status code" 200,"response headers" {"date" "thu, 09 jan 2025 09 22 15 gmt","content type" "application/json;charset=utf 8","server" "atlassianedge","timing allow origin" " ","x arequestid" "3755c266a371a3de6f4ac4e217c9c2cf","set cookie" "atlassian xsrf token=180eb947a40a03f89fc1aa377d3d0be76190e334 lin; path=/; sames ","x aaccountid" "5d07f57ceec00a0bcb5eca63","cache control" "no cache, no store, no transform","vary" "accept encoding","content encoding" "gzip","x content type options" "nosn create issue creates a new issue or subtask in atlassian jira using specified 'fields' provided in the json body input endpoint url /rest/api/3/issue method post input argument name type required description fields object optional parameter for create issue fields summary string required parameter for create issue fields parent object optional parameter for create issue fields parent key string optional parameter for create issue fields issuetype object required type of the resource fields issuetype id string required unique identifier fields components array optional parameter for create issue fields components id string optional unique identifier fields project object required parameter for create issue fields project id string optional unique identifier fields project key string optional parameter for create issue fields description object optional parameter for create issue fields description type string optional type of the resource fields description version number optional parameter for create issue fields description content array optional response content fields description content type string optional type of the resource fields description content content array optional response content fields description content content text string optional response content fields description content content type string optional type of the resource fields reporter object optional parameter for create issue fields reporter id string optional unique identifier fields fixversions array optional parameter for create issue fields fixversions id string optional unique identifier fields priority object optional parameter for create issue fields priority id string optional unique identifier input example {"json body" {"fields" {"summary" "issue summary","parent" {"key" "sct 214"},"issuetype" {"id" "10000"},"components" \[{"id" "10000"}],"project" {"id" "11435"},"description" {"type" "doc","version" 1,"content" \[{"type" "paragraph","content" \[{"text" "order entry fails when selecting supplier ","type" "text"}]}]},"reporter" {"id" "5b10a2844c20165700ede21g"},"fixversions" \[{"id" "10001"}],"priority" {"id" "20000"},"labels" \["bugfix","blitz test"],"timetracking" {"remainingestimate" "5","originalestimate" "10"},"security" {"id" "10000"},"environment" {"type" "doc","version" 1,"content" \[{"type" "paragraph","content" \[{"text" "uat","type" "text"}]}]},"versions" \[{"id" "10000"}],"duedate" "2019 05 11","assignee" {"id" "5b109f2e9729b51b54dc274d"}}}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier key string output field key self string output field self output example {"id" "12345678 1234 1234 1234 123456789abc","key" "string","self" "string"} edit issue modify an existing issue in atlassian jira using the provided issue id or key and update details endpoint url /rest/api/3/issue/{{issueidorkey}} method put input argument name type required description path parameters issueidorkey string required parameters for the edit issue action historymetadata object optional response data historymetadata actor object optional response data historymetadata actor avatarurl string optional response data historymetadata actor displayname string optional response data historymetadata actor id string optional response data historymetadata actor type string optional response data historymetadata actor url string optional response data historymetadata extradata object optional response data historymetadata extradata iteration string optional response data historymetadata extradata step string optional response data historymetadata description string optional response data historymetadata generator object optional response data historymetadata generator id string optional response data historymetadata generator type string optional response data historymetadata cause object optional response data historymetadata cause id string optional response data historymetadata cause type string optional response data historymetadata activitydescription string optional response data historymetadata type string optional response data update object optional date value update summary array optional parameter for edit issue update summary set string optional parameter for edit issue update components array optional parameter for edit issue update components set string optional parameter for edit issue input example {"json body" {"historymetadata" {"actor" {"avatarurl" "http //mysystem/avatar/tony jpg","displayname" "tony","id" "tony","type" "mysystem user","url" "http //mysystem/users/tony"},"extradata" {"iteration" "10a","step" "4"},"description" "from the order testing process","generator" {"id" "mysystem 1","type" "mysystem application"},"cause" {"id" "myevent","type" "mysystem event"},"activitydescription" "complete order processing","type" "myplugin\ type"},"update" {"summary" \[{"set" "bug in business logic"}],"components" \[{"set" ""}],"timetracking" \[{"edit" {"remainingestimate" "4d","originalestimate" "1w 1d"}}],"labels" \[{"add" "triaged"},{"remove" "blocker"}]},"fields" {"summary" "completed orders still displaying in pending","customfield 10010" 1,"customfield 10000" {"type" "doc","version" 1,"content" \[{"type" "paragraph","content" \[{"text" "investigation underway","type" "text"}]}]}},"properties" \[{"value" "order number 10784","key" "key1"},{"value" "order number 10923","key" "key2"}]},"path parameters" {"issueidorkey" "sct 216"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"response text" "string"} get issue retrieve detailed information for a specific issue in atlassian jira using the provided issue id or key endpoint url /rest/api/3/issue/{{issueidorkey}} method get input argument name type required description path parameters issueidorkey string required parameters for the get issue action input example {"path parameters" {"issueidorkey" "sc 5427"}} output parameter type description status code number http status code of the response reason string response reason phrase expand string output field expand id string unique identifier self string output field self key string output field key fields object output field fields fields parent object output field fields parent fields parent id string unique identifier fields parent key string output field fields parent key fields parent self string output field fields parent self fields parent fields object output field fields parent fields fields parent fields summary string output field fields parent fields summary fields parent fields status object status value fields parent fields status self string status value fields parent fields status description string status value fields parent fields status iconurl string url endpoint for the request fields parent fields status name string name of the resource fields parent fields status id string unique identifier fields parent fields status statuscategory object status value fields parent fields priority object output field fields parent fields priority fields parent fields priority self string output field fields parent fields priority self fields parent fields priority iconurl string url endpoint for the request fields parent fields priority name string name of the resource fields parent fields priority id string unique identifier output example {"expand" "string","id" "12345678 1234 1234 1234 123456789abc","self" "string","key" "string","fields" {"parent" {"id" "12345678 1234 1234 1234 123456789abc","key" "string","self" "string","fields" {}},"resolution" {},"lastviewed" {},"labels" \[{}],"aggregatetimeoriginalestimate" {},"issuelinks" \[{}],"assignee" {"self" "string","accountid" "string","emailaddress" "string","avatarurls" {},"displayname" "example name","active"\ true,"timezone" "string","accounttype" "string"},"subtasks" \[{}],"report search executes a jql based search for issues in atlassian jira using specified criteria and returns matching results endpoint url /rest/api/3/search/jql method post input argument name type required description expand string optional to include additional information about issues in the response note that, unlike the majority of instances where expand is specified, expand is defined as a comma delimited string of values fields array optional a list of fields to return for each issue use it to retrieve a subset of fields this parameter accepts a comma separated list fieldsbykeys boolean optional reference fields by their key (rather than id) jql string optional for performance reasons, this parameter requires a bounded query a bounded query is a query with a search restriction maxresults number optional the maximum number of items to return per page to manage page size, api may return fewer items per page where a large number of fields are requested the greatest number of items returned per page is achieved when requesting id or key only it returns max 5000 issues nextpagetoken string optional the token for a page to fetch that is not the first page the first page has a nextpagetoken of null use the nextpagetoken to fetch the next page of issues properties array optional a list of up to 5 issue properties to include in the results this parameter accepts a comma separated list reconcileissues array optional strong consistency issue ids to be reconciled with search results accepts max 50 ids input example {"json body" {"expand" "names","fields" \["id"],"fieldsbykeys"\ true,"jql" "assignee = currentuser() order by key","maxresults" 273,"nextpagetoken" "testing","properties" \["property 1"],"reconcileissues" \[2154]}} output parameter type description status code number http status code of the response reason string response reason phrase islast boolean output field islast issues array output field issues issues expand string output field issues expand issues fields object output field issues fields issues fields watcher object output field issues fields watcher issues fields watcher iswatching boolean output field issues fields watcher iswatching issues fields watcher self string output field issues fields watcher self issues fields watcher watchcount number count value issues fields attachment array output field issues fields attachment issues fields attachment author object output field issues fields attachment author issues fields attachment author accountid string unique identifier issues fields attachment author accounttype string type of the resource issues fields attachment author active boolean output field issues fields attachment author active issues fields attachment author avatarurls object url endpoint for the request issues fields attachment author displayname string name of the resource issues fields attachment author key string output field issues fields attachment author key issues fields attachment author name string name of the resource issues fields attachment author self string output field issues fields attachment author self issues fields attachment content string response content issues fields attachment created string output field issues fields attachment created issues fields attachment filename string name of the resource issues fields attachment id number unique identifier issues fields attachment mimetype string type of the resource output example {"islast"\ true,"issues" \[{"expand" "string","fields" {},"id" "12345678 1234 1234 1234 123456789abc","key" "string","self" "string"}]} transition issue performs a transition for a specified jira issue using the issueidorkey, and updates fields if the transition has an associated screen endpoint url /rest/api/3/issue/{{issueidorkey}}/transitions method post input argument name type required description path parameters issueidorkey string required the id or key of the issue to transition fields object optional the fields to update on the issue fields assignee object optional the user to assign the issue to fields assignee name string optional the name of the user to assign the issue to fields resolution object optional the resolution of the issue fields resolution name string optional name of the resource historymetadata object optional the metadata for the history of the issue historymetadata activitydescription string optional the description of the activity historymetadata actor object optional the actor of the activity historymetadata actor avatarurl string optional the url of the avatar of the actor historymetadata actor displayname string optional the display name of the actor historymetadata actor id string optional the id of the actor historymetadata actor type string optional the type of the actor historymetadata actor url string optional the url of the actor historymetadata cause object optional the cause of the activity historymetadata cause id string optional the id of the cause historymetadata cause type string optional response data historymetadata description string optional response data historymetadata extradata object optional the extra data of the activity historymetadata extradata iteration string optional the iteration of the activity historymetadata extradata step string optional the step of the activity historymetadata generator object optional the generator of the activity historymetadata generator id string optional the id of the generator historymetadata generator type string optional response data historymetadata type string optional the type of the activity input example {"json body" {"fields" {"assignee" {"name" "bob"},"resolution" {"name" "fixed"}},"historymetadata" {"activitydescription" "complete order processing","actor" {"avatarurl" "http //mysystem/avatar/tony jpg","displayname" "tony","id" "tony","type" "mysystem user","url" "http //mysystem/users/tony"},"cause" {"id" "myevent","type" "mysystem event"},"description" "from the order testing process","extradata" {"iteration" "10a","step" "4"},"generator" {"id" "mysystem 1","type" "mysystem application"},"type" "myplugin\ type"},"transition" {"id" "5"},"update" {"comment" \[{"add" {"body" {"content" \[{"content" \[{"text" "bug has been fixed","type" "text"}],"type" "paragraph"}],"type" "doc","version" 1}}}]}},"path parameters" {"issueidorkey" "scrum 1"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {},"reason" "no content","response text" ""} add comment adds or updates a comment on an atlassian jira issue identified by issueidorkey and comment id endpoint url /rest/api/3/issue/{{issueidorkey}}/comment/{{id}} method put input argument name type required description path parameters issueidorkey string required the id or key of the issue path parameters id string required the id of the comment parameters notifyusers boolean optional whether users are notified when a comment is updated parameters overrideeditableflag boolean optional whether screen security is overridden to enable uneditable fields to be edited available to connect app users with the administer jira global permission and forge apps acting on behalf of users with administer jira global permission parameters expand string optional use expand to include additional information about comments in the response this parameter accepts renderedbody, which returns the comment body rendered in html visibility object optional the group or role to which this comment is visible optional on create and update visibility identifier string optional the id of the group or the name of the role that visibility of this item is restricted to visibility type string optional whether visibility of this item is restricted to a group or role visibility value string optional the name of the group or role that visibility of this item is restricted to please note that the name of a group is mutable, to reliably identify a group use identifier body object optional the comment text in atlassian document format body type string optional request body data body version number optional request body data body content array required request body data body content type string optional request body data body content content array optional request body data body content content type string optional request body data body content content text string optional request body data properties array optional a list of comment properties optional on create and update properties key string optional the key of the property required on create and update properties value string optional the value of the property required on create and update input example {"parameters" {"notifyusers"\ true,"overrideeditableflag"\ false,"expand" "renderedbody"},"json body" {"visibility" {"identifier" "administrators","type" "role","value" "administrators"},"body" {"type" "doc","version" 1,"content" \[{"type" "paragraph","content" \[{"type" "text","text" "updated comment content"}]}]},"properties" \[{"key" "comment property key","value" "property value"}]},"path parameters" {"issueidorkey" "proj 123","id" 10001}} output parameter type description status code number http status code of the response reason string response reason phrase self string output field self id string unique identifier author object output field author author self string output field author self author accountid string unique identifier author active boolean output field author active author displayname string name of the resource body object request body data body type string request body data body version number request body data body content array request body data body content type string request body data body content content array request body data body content content type string request body data body content content text string request body data created string output field created updated string output field updated updateauthor object output field updateauthor updateauthor self string output field updateauthor self updateauthor accountid string unique identifier updateauthor active boolean output field updateauthor active updateauthor displayname string name of the resource visibility object output field visibility output example {"self" "string","id" "12345678 1234 1234 1234 123456789abc","author" {"self" "string","accountid" "string","active"\ true,"displayname" "example name"},"body" {"type" "string","version" 123,"content" \[{}]},"created" "2024 01 01t00 00 00z","updated" "2024 01 01t00 00 00z","updateauthor" {"self" "string","accountid" "string","active"\ true,"displayname" "example name"},"visibility" {"identifier" "string","type" "string","value" "string"}} response headers header description example atl request id http response header atl request id d99ae7c1 56c8 4ec3 be94 36847ece934f atl traceid http response header atl traceid 13d28234934c4319902f54f1c38e5fff beta retry after http response header beta retry after 1 cache control directives for caching mechanisms no cache, no store, no transform connection http response header connection keep alive 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, 09 jan 2025 09 22 15 gmt expect ct http response header expect ct location the url to redirect a page to 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=348,atl edge internal;dur=15,atl edge upstream;dur=335,atl edge pop;desc="aws ap south 1" set cookie http response header set cookie atlassian xsrf token=5b8d9da0169a025c9f394f0e4434c12aa4e646d5 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 via http response header via 1 1 0298f468fb8a5be020d6f3e7ff839738 cloudfront net (cloudfront) x aaccountid http response header x aaccountid 5d07f57ceec00a0bcb5eca63 x amz cf id http response header x amz cf id zklyd pa7of c1e8kspsszlzxefilykb0hwus4dcqcas v5wrpxza== x amz cf pop http response header x amz cf pop bom78 p1 x arequestid http response header x arequestid 3755c266a371a3de6f4ac4e217c9c2cf x beta ratelimit limit http response header x beta ratelimit limit 200 x beta ratelimit reason http response header x beta ratelimit reason jira burst based x beta ratelimit remaining http response header x beta ratelimit remaining 199 x beta ratelimit reset http response header x beta ratelimit reset 2025 09 08t10 41z x cache http response header x cache miss from cloudfront x content type options http response header x content type options nosniff x xss protection http response header x xss protection 1; mode=block