{"openapi":"3.0.1","info":{"title":"Service Desk Public REST API","description":"Public REST API for Jira Service Desk","termsOfService":"https://www.atlassian.com/legal/customer-agreement","version":"1001.0.0-SNAPSHOT"},"servers":[{"url":"https://your-domain.atlassian.net"}],"tags":[{"name":"Customer"},{"name":"Info"},{"name":"Knowledgebase"},{"name":"Organization"},{"name":"Request"},{"name":"Requesttype"},{"name":"Servicedesk"}],"paths":{"/rest/servicedeskapi/customer":{"post":{"tags":["Customer"],"summary":"Create customer","description":"This method adds a customer to the Jira Service Desk instance by passing a JSON file including an email address and display name. The display name does not need to be unique. The record's identifiers, `name` and `key`, are automatically generated from the request details.\n\n**[Permissions](#permissions) required**: Jira Administrator Global permission","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerResource.createCustomer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerCreateDTO"},"example":{"displayName":"Fred F. User","email":"fred@example.com"}}},"required":true},"responses":{"201":{"description":"Returns the customer details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDTO"},"example":"{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}"}}},"400":{"description":"Returned if the request is invalid, either because the email address is incorrectly formed or already exists in the database.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"ADMIN"}},"/rest/servicedeskapi/info":{"get":{"tags":["Info"],"summary":"Get info","description":"This method retrieves information about the Jira Service Desk instance such as software version, builds, and related links.\n\n**[Permissions](#permissions) required**: None, the user does not need to be logged in.","operationId":"com.atlassian.servicedesk.api.rest.resource.SoftwareInfoResource.getInfo_get","responses":{"200":{"description":"Returns the runtime information for the Jira Service Desk instance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoftwareInfoDTO"},"example":"{\"version\":\"3.0.1\",\"platformVersion\":\"7.0.1\",\"buildDate\":{\"iso8601\":\"2015-09-15T02:34:00+0700\",\"jira\":\"2015-09-15T02:34:00.000+0700\",\"friendly\":\"Monday 02:34 AM\",\"epochMillis\":1442259240000},\"buildChangeSet\":\"c6679417c550918e7c94a9eaaada133f15dc8ff0\",\"isLicensedForUse\":true,\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/info\"}}"}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/knowledgebase/article":{"get":{"tags":["Knowledgebase"],"summary":"Get articles","description":"Returns articles which match the given query string across all service desks.\n\n**[Permissions](#permissions) required**: Permission to access the [customer portal](https://confluence.atlassian.com/servicedeskcloud/configuring-the-customer-portal-732528918.html).","operationId":"com.atlassian.servicedesk.api.rest.resource.KBResource.getArticles_get","parameters":[{"name":"query","in":"query","description":"The string used to filter the articles (required).","schema":{"type":"string"}},{"name":"highlight","in":"query","description":"If set to true matching query term in the title and excerpt will be highlighted using the \\{@code @@@hl@@@term@@@endhl@@@\\} syntax. Default: false.","schema":{"type":"boolean","default":false}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the articles, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOArticleDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article?start=0&limit=2\"},\"values\":[{\"title\":\"Stolen computer\",\"excerpt\":\"assuming your computer was stolen\",\"source\":{\"type\":\"confluence\",\"pageId\":\"8786177\",\"spaceKey\":\"IT\"},\"content\":{\"iframeSrc\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8786177\"}},{\"title\":\"Upgrading computer\",\"excerpt\":\"each computer older then 3 years can be upgraded\",\"source\":{\"type\":\"confluence\",\"pageId\":\"8785228\",\"spaceKey\":\"IT\"},\"content\":{\"iframeSrc\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8785228\"}}]}"}}},"400":{"description":"Returned if the request is invalid. For example: missing query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-experimental":true,"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/organization":{"get":{"tags":["Organization"],"summary":"Get organizations","description":"This method returns a list of organizations in the Jira Service Desk instance. Use this method when you want to present a list of organizations or want to locate an organization by name.\n\n**[Permissions](#permissions) required**: Any\n\n**Response limitations**: If the user is a customer, only those organizations of which the customer is a member are listed.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.getOrganizations_get","parameters":[{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of organizations to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns paginated list of organizations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOOrganizationDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization?start=0&limit=1\"},\"values\":[{\"id\":\"1\",\"name\":\"Charlie Cakes Franchises\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Organization"],"summary":"Create organization","description":"This method creates an organization by passing the name of the organization.\n\n**[Permissions](#permissions) required**: Service desk administrator or agent. Note: Permission to create organizations can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.createOrganization_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCreateDTO"},"example":{"name":"Charlie Cakes Franchises"}}},"required":true},"responses":{"201":{"description":"Returns the created organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDTO"},"example":"{\"id\":\"1\",\"name\":\"Charlie Cakes Franchises\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1\"}}"}}},"400":{"description":"Returned if the HTTP request is invalid, which if the HTTP request was correctly formed means that the organization name already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"ADMIN"}},"/rest/servicedeskapi/organization/{organizationId}":{"get":{"tags":["Organization"],"summary":"Get organization","description":"This method returns details of an organization. Use this method to get organization details whenever your application component is passed an organization ID but needs to display other organization details.\n\n**[Permissions](#permissions) required**: Any\n\n**Response limitations**: Customers can only retrieve organization of which they are members.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.getOrganization_get","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the requested organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDTO"},"example":"{\"id\":\"1\",\"name\":\"Charlie Cakes Franchises\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"READ"},"delete":{"tags":["Organization"],"summary":"Delete organization","description":"This method deletes an organization. Note that the organization is deleted regardless of other associations it may have. For example, associations with service desks.\n\n**[Permissions](#permissions) required**: Jira administrator.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.deleteOrganization_delete","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"204":{"description":"Returned if the organization was deleted."},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"DELETE"}},"/rest/servicedeskapi/organization/{organizationId}/property":{"get":{"tags":["Organization"],"summary":"Get properties keys","description":"Returns the keys of all properties for an organization. Use this resource when you need to find out what additional properties items have been added to an organization.\n\n**[Permissions](#permissions) required**: Any\n\n**Response limitations**: Customers can only access properties of organizations of which they are members.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationPropertyResource.getPropertiesKeys_get","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization from which keys will be returned.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returned if the organization was found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyKeys"},"example":"{\"keys\":[{\"self\":\"/rest/servicedeskapi/organization/1/property/propertyKey\",\"key\":\"organization.attributes\"}]}"}}},"400":{"description":"Returned if the organization ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}":{"get":{"tags":["Organization"],"summary":"Get property","description":"Returns the value of a property from an organization. Use this method to obtain the JSON content for an organization's property.\n\n**[Permissions](#permissions) required**: Any\n\n**Response limitations**: Customers can only access properties of organizations of which they are members.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationPropertyResource.getProperty_get","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization from which the property will be returned.","required":true,"schema":{"type":"string"}},{"name":"propertyKey","in":"path","description":"The key of the property to return.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the organization's property.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityProperty"},"example":"{\"key\":\"organization.attributes\",\"value\":{\"phone\":\"0800-1233456789\",\"mail\":\"charlie@example.com\"}}"}}},"400":{"description":"Returned if the organization ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization or property do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"INACCESSIBLE"},"put":{"tags":["Organization"],"summary":"Set property","description":"Sets the value of a property for an organization. Use this resource to store custom data against an organization.\n\n**[Permissions](#permissions) required**: Service Desk Administrator or Agent.\n\nNote: Permission to manage organizations can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationPropertyResource.setProperty_put","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization on which the property will be set.","required":true,"schema":{"type":"string"}},{"name":"propertyKey","in":"path","description":"The key of the organization's property. The maximum length of the key is 255 bytes.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returned if the organization property was updated.","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Returned if the organization property was created.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Returned if the organization ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"INACCESSIBLE"},"delete":{"tags":["Organization"],"summary":"Delete property","description":"Removes a property from an organization.\n\n**[Permissions](#permissions) required**: Service Desk Administrator or Agent.\n\nNote: Permission to manage organizations can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationPropertyResource.deleteProperty_delete","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization from which the property will be removed.","required":true,"schema":{"type":"string"}},{"name":"propertyKey","in":"path","description":"The key of the property to remove.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Returned if the organization property was removed."},"400":{"description":"Returned if the organization ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization or property do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/organization/{organizationId}/user":{"get":{"tags":["Organization"],"summary":"Get users in organization","description":"This method returns all the users associated with an organization. Use this method where you want to provide a list of users for an organization or determine if a user is associated with an organization.\n\n**[Permissions](#permissions) required**: Service desk administrator or agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.getUsersInOrganization_get","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of users to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns a paged list of users associated with the organization, ordered by their accountId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOUserDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1/user?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1/user?start=0&limit=1\"},\"values\":[{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd\",\"emailAddress\":\"bob@example.com\",\"displayName\":\"Bob D. Builder\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Organization"],"summary":"Add users to organization","description":"This method adds users to an organization.\n\n**[Permissions](#permissions) required**: Service desk administrator or agent. Note: Permission to add users to an organization can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.addUsersToOrganization_post","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization.","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersOrganizationUpdateDTO"},"example":{"accountIds":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd"],"usernames":[]}}},"required":true},"responses":{"204":{"description":"Returned if all the users were valid and added to the organization, no response payload is provided."},"400":{"description":"Returned if one or more usernames are unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"ADMIN"},"delete":{"tags":["Organization"],"summary":"Remove users from organization","description":"This method removes users from an organization.\n\n**[Permissions](#permissions) required**: Service desk administrator or agent. Note: Permission to delete users from an organization can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationResource.removeUsersFromOrganization_delete","parameters":[{"name":"organizationId","in":"path","description":"The ID of the organization.","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersOrganizationUpdateDTO"},"example":{"accountIds":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd"],"usernames":[]}}},"required":true},"responses":{"204":{"description":"The request completed successfully. No additional content will be sent in the response."},"400":{"description":"Returned if one or more user names are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the organization does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"DELETE"}},"/rest/servicedeskapi/request":{"get":{"tags":["Request"],"summary":"Get customer requests","description":"This method returns all customer requests for the user executing the query.\n\nThe returned customer requests are ordered chronologically by the latest activity on each request. For example, the latest status transition or comment.\n\n**[Permissions](#permissions) required**: Permission to access the specified service desk.\n\n**Response limitations**: For customers, the list returned will include request they created (or were created on their behalf) or are participating in only.","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerRequestResource.getCustomerRequests_get","parameters":[{"name":"searchTerm","in":"query","description":"Filters customer requests where the request summary matches the `searchTerm`. [Wildcards](https://confluence.atlassian.com/display/JIRACORECLOUD/Search+syntax+for+text+fields) can be used in the `searchTerm` parameter.","schema":{"type":"string"}},{"name":"requestOwnership","in":"query","description":"Filters customer requests using the following values:\n\n *  `OWNED_REQUESTS` returns customer requests where the user is the creator.\n *  `PARTICIPATED_REQUESTS` returns customer requests where the user is a participant.\n *  `ORGANIZATION` returns customer requests for an organization of which the user is a member when used in conjunction with `organizationId`.\n *  `ALL_ORGANIZATIONS` returns customer requests that belong to all organizations of which the user is a member.\n *  `APPROVER` returns customer requests where the user is an approver. Can be used in conjunction with `approvalStatus` to filter pending or complete approvals.\n *  `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.**\n\nMultiple values of the query parameter are supported. For example, `requestOwnership=OWNED_REQUESTS&requestOwnership=PARTICIPATED_REQUESTS` will only return customer requests where the user is the creator or a participant. If not specified, filtering defaults to `OWNED_REQUESTS`, `PARTICIPATED_REQUESTS`, and `ALL_ORGANIZATIONS`.","schema":{"type":"array","items":{"type":"string"}}},{"name":"requestStatus","in":"query","description":"Filters customer requests where the request is closed, open, or either of the two where:\n\n *  `CLOSED_REQUESTS` returns customer requests that are closed.\n *  `OPEN_REQUESTS` returns customer requests that are open.\n *  `ALL_REQUESTS` returns all customer requests.","schema":{"type":"string"}},{"name":"approvalStatus","in":"query","description":"Filters results to customer requests based on their approval status:\n\n *  `MY_PENDING_APPROVAL` returns customer requests pending the user's approval.\n *  `MY_HISTORY_APPROVAL` returns customer requests where the user was an approver.\n\n**Note**: Valid only when used with requestOwnership=APPROVER.","schema":{"type":"string"}},{"name":"organizationId","in":"query","description":"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.","schema":{"type":"integer","format":"int32"}},{"name":"serviceDeskId","in":"query","description":"Filters customer requests by service desk.","schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"query","description":"Filters customer requests by request type. Note that the `serviceDeskId` must be specified for the service desk in which the request type belongs.","schema":{"type":"integer","format":"int32"}},{"name":"expand","in":"query","description":"A multi-value parameter indicating which properties of the customer request to expand, where:\n\n *  `serviceDesk` returns additional details for each service desk.\n *  `requestType` returns additional details for each request type.\n *  `participant` returns the participant details, if any, for each customer request.\n *  `sla` returns the SLA information on each customer request.\n *  `status` returns the status transitions, in chronological order, for each customer request.\n *  `attachment` returns the attachments for the customer request.\n *  `action` returns the actions that the user can or cannot perform on this customer request.\n *  `comment` returns the comments, if any, for each customer request.\n *  `comment.attachment` returns the attachment details, if any, for each comment.\n *  `comment.renderedBody` (Experimental) returns the rendered body in HTML format (in addition to the raw body) for each comment.","schema":{"type":"array","items":{"type":"string"}}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the customer requests, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOCustomerRequestDTO"},"example":"{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request?start=0&limit=3\"},\"values\":[{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"issueId\":\"107001\",\"issueKey\":\"HELPDESK-1\",\"requestTypeId\":\"25\",\"serviceDeskId\":\"10\",\"createdDate\":{\"iso8601\":\"2015-10-08T14:42:00+0700\",\"jira\":\"2015-10-08T14:42:00.000+0700\",\"friendly\":\"Monday 14:42 PM\",\"epochMillis\":1444290120000},\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"requestFieldValues\":[{\"fieldId\":\"summary\",\"label\":\"What do you need?\",\"value\":\"Request JSD help via REST\"},{\"fieldId\":\"description\",\"label\":\"Why do you need this?\",\"value\":\"I need a new *mouse* for my Mac\",\"renderedValue\":{\"html\":\"<p>I need a new <b>mouse</b> for my Mac</p>\"}}],\"currentStatus\":{\"status\":\"Waiting for Support\",\"statusCategory\":\"NEW\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:01:00+0700\",\"jira\":\"2015-10-08T14:01:00.000+0700\",\"friendly\":\"Today 14:01 PM\",\"epochMillis\":1444287660000}},\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/issue/107001\",\"web\":\"https://your-domain.atlassian.net/servicedesk/customer/portal/10/HELPDESK-1\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/107001\"}},{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"issueId\":\"107002\",\"issueKey\":\"HELPDESK-2\",\"requestTypeId\":\"25\",\"serviceDeskId\":\"10\",\"createdDate\":{\"iso8601\":\"2015-10-08T14:30:00+0700\",\"jira\":\"2015-10-08T14:30:00.000+0700\",\"friendly\":\"Monday 14:30 PM\",\"epochMillis\":1444289400000},\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"requestFieldValues\":[{\"fieldId\":\"summary\",\"label\":\"What do you need?\",\"value\":\"Request a new account\"},{\"fieldId\":\"description\",\"label\":\"Why do you need this?\",\"value\":\"Create an account on Jira\"}],\"currentStatus\":{\"status\":\"Waiting for Support\",\"statusCategory\":\"NEW\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:01:00+0700\",\"jira\":\"2015-10-08T14:01:00.000+0700\",\"friendly\":\"Today 14:01 PM\",\"epochMillis\":1444287660000}},\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/issue/107002\",\"web\":\"https://your-domain.atlassian.net/servicedesk/customer/portal/10/HELPDESK-2\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/107002\"}},{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"issueId\":\"109006\",\"issueKey\":\"SIMPLEDESK-6\",\"requestTypeId\":\"33\",\"serviceDeskId\":\"12\",\"createdDate\":{\"iso8601\":\"2015-10-05T14:30:00+0700\",\"jira\":\"2015-10-05T14:30:00.000+0700\",\"friendly\":\"Monday 14:30 PM\",\"epochMillis\":1444030200000},\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"requestFieldValues\":[{\"fieldId\":\"summary\",\"label\":\"Summarize the problem\",\"value\":\"Printer on level 3 did not work\"},{\"fieldId\":\"description\",\"value\":\"Ink cartridge is empty\"}],\"currentStatus\":{\"status\":\"Waiting for Support\",\"statusCategory\":\"NEW\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:00:00+0700\",\"jira\":\"2015-10-08T14:00:00.000+0700\",\"friendly\":\"Today 14:00 PM\",\"epochMillis\":1444287600000}},\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/issue/109006\",\"web\":\"https://your-domain.atlassian.net/servicedesk/customer/portal/12/SIMPLEDESK-6\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/109006\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the user does not have permission to access the service desk, the service desk does not exist, or the service desk does not support the request type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Create customer request","description":"This method creates a customer request in a service desk.\n\nThe 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](#api-servicedesk-serviceDeskId-requesttype-requestTypeId-field-get).\n\nThe fields required for a customer request type depend on the user's permissions:\n\n *  `raiseOnBehalfOf` is not available to Users who have the customer permission only.\n *  `requestParticipants` is not available to Users who have the customer permission only or if the feature is turned off for customers.\n\n`requestFieldValues` is a map of Jira field IDs and their values. See [Field input formats](#fieldformats), for details of each field's JSON semantics and the values they can take.\n\n**[Permissions](#permissions) required**: Permission to create requests in the specified service desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerRequestResource.createCustomerRequest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestCreateDTO"},"example":{"requestParticipants":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"],"serviceDeskId":"10","requestTypeId":"25","requestFieldValues":{"summary":"Request JSD help via REST","description":"I need a new *mouse* for my Mac"}}}},"required":true},"responses":{"201":{"description":"Returned if the customer request was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerRequestDTO"},"example":"{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"issueId\":\"107001\",\"issueKey\":\"HELPDESK-1\",\"requestTypeId\":\"25\",\"serviceDeskId\":\"10\",\"createdDate\":{\"iso8601\":\"2015-10-08T14:42:00+0700\",\"jira\":\"2015-10-08T14:42:00.000+0700\",\"friendly\":\"Monday 14:42 PM\",\"epochMillis\":1444290120000},\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"requestFieldValues\":[{\"fieldId\":\"summary\",\"label\":\"What do you need?\",\"value\":\"Request JSD help via REST\"},{\"fieldId\":\"description\",\"label\":\"Why do you need this?\",\"value\":\"I need a new *mouse* for my Mac\",\"renderedValue\":{\"html\":\"<p>I need a new <b>mouse</b> for my Mac</p>\"}}],\"currentStatus\":{\"status\":\"Waiting for Support\",\"statusCategory\":\"NEW\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:01:00+0700\",\"jira\":\"2015-10-08T14:01:00.000+0700\",\"friendly\":\"Today 14:01 PM\",\"epochMillis\":1444287660000}},\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/issue/107001\",\"web\":\"https://your-domain.atlassian.net/servicedesk/customer/portal/10/HELPDESK-1\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/107001\"}}"}}},"400":{"description":"Returned if the HTTP request call is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{issueIdOrKey}":{"get":{"tags":["Request"],"summary":"Get customer request by id or key","description":"This method returns a customer request.\n\n**[Permissions](#permissions) required**: Permission to access the specified service desk.\n\n**Response limitations**: For customers, only a request they created, was created on their behalf, or they are participating in will be returned.","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerRequestResource.getCustomerRequestByIdOrKey_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or Key of the customer request to be returned","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","description":"A multi-value parameter indicating which properties of the customer request to expand, where:\n\n *  `serviceDesk` returns additional service desk details.\n *  `requestType` returns additional customer request type details.\n *  `participant` returns the participant details.\n *  `sla` returns the SLA information.\n *  `status` returns the status transitions, in chronological order.\n *  `attachment` returns the attachments.\n *  `action` returns the actions that the user can or cannot perform.\n *  `comment` returns the comments.\n *  `comment.attachment` returns the attachment details for each comment.\n *  `comment.renderedBody` (Experimental) return the rendered body in HTML format (in addition to the raw body) for each comment.","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Returns the customer request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerRequestDTO"},"example":"{\"_expands\":[\"participant\",\"status\",\"sla\",\"requestType\",\"serviceDesk\",\"attachment\",\"action\",\"comment\"],\"issueId\":\"107001\",\"issueKey\":\"HELPDESK-1\",\"requestTypeId\":\"25\",\"serviceDeskId\":\"10\",\"createdDate\":{\"iso8601\":\"2015-10-08T14:42:00+0700\",\"jira\":\"2015-10-08T14:42:00.000+0700\",\"friendly\":\"Monday 14:42 PM\",\"epochMillis\":1444290120000},\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"requestFieldValues\":[{\"fieldId\":\"summary\",\"label\":\"What do you need?\",\"value\":\"Request JSD help via REST\"},{\"fieldId\":\"description\",\"label\":\"Why do you need this?\",\"value\":\"I need a new *mouse* for my Mac\",\"renderedValue\":{\"html\":\"<p>I need a new <b>mouse</b> for my Mac</p>\"}}],\"currentStatus\":{\"status\":\"Waiting for Support\",\"statusCategory\":\"NEW\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:01:00+0700\",\"jira\":\"2015-10-08T14:01:00.000+0700\",\"friendly\":\"Today 14:01 PM\",\"epochMillis\":1444287660000}},\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/issue/107001\",\"web\":\"https://your-domain.atlassian.net/servicedesk/customer/portal/10/HELPDESK-1\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/107001\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/approval":{"get":{"tags":["Request"],"summary":"Get approvals","description":"This method returns all approvals on a customer request.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.ApprovalResource.getApprovals_get","parameters":[{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of approvals to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be queried for its approvals.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the customer request's approvals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOApprovalDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval?start=0&limit=3\"},\"values\":[{\"id\":\"1\",\"name\":\"Please approve this request\",\"finalDecision\":\"approved\",\"canAnswerApproval\":false,\"approvers\":[{\"approver\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"approverDecision\":\"approved\"}],\"createdDate\":{\"iso8601\":\"2016-09-28T14:01:00+0700\",\"jira\":\"2016-09-28T14:01:00.000+0700\",\"friendly\":\"Monday 14:01 PM\",\"epochMillis\":1475046060000},\"completedDate\":{\"iso8601\":\"2016-09-29T14:30:00+0700\",\"jira\":\"2016-09-29T14:30:00.000+0700\",\"friendly\":\"Today 14:30 PM\",\"epochMillis\":1475134200000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval/1\"}},{\"id\":\"2\",\"name\":\"Waiting for approval\",\"finalDecision\":\"declined\",\"canAnswerApproval\":false,\"approvers\":[{\"approver\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"approverDecision\":\"approved\"}],\"createdDate\":{\"iso8601\":\"2016-10-05T14:01:00+0700\",\"jira\":\"2016-10-05T14:01:00.000+0700\",\"friendly\":\"Wednesday 14:01 PM\",\"epochMillis\":1475650860000},\"completedDate\":{\"iso8601\":\"2016-10-06T14:30:00+0700\",\"jira\":\"2016-10-06T14:30:00.000+0700\",\"friendly\":\"Thursday 14:30 PM\",\"epochMillis\":1475739000000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval/2\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/approval/{approvalId}":{"get":{"tags":["Request"],"summary":"Get approval by id","description":"This method returns an approval. Use this method to determine the status of an approval and the list of approvers.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.ApprovalResource.getApprovalById_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request the approval is on.","required":true,"schema":{"type":"string"}},{"name":"approvalId","in":"path","description":"The ID of the approval to be returned.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the requested approval.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDTO"},"example":"{\"id\":\"1\",\"name\":\"Please approve this request\",\"finalDecision\":\"approved\",\"canAnswerApproval\":false,\"approvers\":[{\"approver\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"approverDecision\":\"approved\"}],\"createdDate\":{\"iso8601\":\"2016-09-28T14:01:00+0700\",\"jira\":\"2016-09-28T14:01:00.000+0700\",\"friendly\":\"Monday 14:01 PM\",\"epochMillis\":1475046060000},\"completedDate\":{\"iso8601\":\"2016-09-29T14:30:00+0700\",\"jira\":\"2016-09-29T14:30:00.000+0700\",\"friendly\":\"Today 14:30 PM\",\"epochMillis\":1475134200000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval/1\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request or approval do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Answer approval","description":"This method enables a user to **Approve** or **Decline** an approval on a customer request. The approval is assumed to be owned by the user making the call.\n\n**[Permissions](#permissions) required**: User is assigned to the approval request.","operationId":"com.atlassian.servicedesk.api.rest.resource.ApprovalResource.answerApproval_post","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be updated.","required":true,"schema":{"type":"string"}},{"name":"approvalId","in":"path","description":"The ID of the approval to be updated.","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecisionRequestDTO"},"example":{"decision":"approve"}}},"required":true},"responses":{"200":{"description":"Returns the updated approval.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDTO"},"example":"{\"id\":\"1\",\"name\":\"Please approve this request\",\"finalDecision\":\"approved\",\"canAnswerApproval\":false,\"approvers\":[{\"approver\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"approverDecision\":\"approved\"}],\"createdDate\":{\"iso8601\":\"2016-09-28T14:01:00+0700\",\"jira\":\"2016-09-28T14:01:00.000+0700\",\"friendly\":\"Monday 14:01 PM\",\"epochMillis\":1475046060000},\"completedDate\":{\"iso8601\":\"2016-09-29T14:30:00+0700\",\"jira\":\"2016-09-29T14:30:00.000+0700\",\"friendly\":\"Today 14:30 PM\",\"epochMillis\":1475134200000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2/approval/1\"}}"}}},"400":{"description":"Returned if the customer request isn't awaiting the approval or the approval has already been provided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request or the approval do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/attachment":{"get":{"tags":["Request"],"summary":"Get attachments for request","description":"This method returns all the attachments for a customer requests.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.\n\n**Response limitations**: Customers will only get a list of public attachments.","operationId":"com.atlassian.servicedesk.api.rest.resource.AttachmentResource.getAttachmentsForRequest_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request from which the attachments will be listed.","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned attachment. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of comments to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the visible attachments from the customer request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOAttachmentDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=0&limit=2\"},\"values\":[{\"filename\":\"screenshot.png\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":23123,\"mimeType\":\"image/png\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10000\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10000/screenshot.png\",\"thumbnail\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/thumbnail/10000/_thumb_10000.png\"}},{\"filename\":\"log.txt\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":32132,\"mimeType\":\"text/plain\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10001\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10001/log.txt\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Create attachment","description":"This method adds one or more temporary files (attached to the request's service desk using [servicedesk/\\{serviceDeskId\\}/attachTemporaryFile](#api-servicedesk-serviceDeskId-attachTemporaryFile-post)) as attachments to a customer request and set the attachment visibility using the `public` flag. Also, it is possible to include a comment with the attachments.\n\nTo get a list of attachments for a comment on the request use [servicedeskapi/request/\\{issueIdOrKey\\}/comment/\\{commentId\\}/attachment](#api-request-issueIdOrKey-comment-commentId-attachment-get).\n\n**[Permissions](#permissions) required**: Permission to add an attachment.\n\n**Request limitations**: Customers can set attachments to public visibility only.","operationId":"com.atlassian.servicedesk.api.rest.resource.AttachmentResource.createAttachment_post","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to which the attachment will be added.","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachmentCreateDTO"},"example":{"temporaryAttachmentIds":["temp910441317820424274","temp3600755449679003114"],"public":true,"additionalComment":{"body":"Please find the screenshot and the log file attached."}}}},"required":true},"responses":{"201":{"description":"Returns the attachments and comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachmentCreateResultDTO"},"example":"{\"comment\":{\"_expands\":[\"attachment\",\"renderedBody\"],\"id\":\"1000\",\"body\":\"Please find the screenshot and the log file attached. !screenshot.png|thumbnail! [^log.txt] _(32 kB)_\",\"public\":true,\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment/1000\"}},\"attachments\":{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=0&limit=2\"},\"values\":[{\"filename\":\"screenshot.png\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":23123,\"mimeType\":\"image/png\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10000\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10000/screenshot.png\",\"thumbnail\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/thumbnail/10000/_thumb_10000.png\"}},{\"filename\":\"log.txt\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":32132,\"mimeType\":\"text/plain\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10001\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10001/log.txt\"}}]}}"}}},"400":{"description":"Returned if the HTTP request is invalid, including missing the required `public` field or list of temporary file IDs, or if the temporary files have expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/comment":{"get":{"tags":["Request"],"summary":"Get request comments","description":"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.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.\n\n**Response limitations**: Customers are returned public comments only.","operationId":"com.atlassian.servicedesk.api.rest.resource.CommentResource.getRequestComments_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request whose comments will be retrieved.","required":true,"schema":{"type":"string"}},{"name":"public","in":"query","description":"Specifies whether to return public comments or not. Default: true.","schema":{"type":"boolean"}},{"name":"internal","in":"query","description":"Specifies whether to return internal comments or not. Default: true.","schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"A multi-value parameter indicating which properties of the comment to expand:\n\n *  `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](#api-request-issueIdOrKey-attachment-get).)\n *  `renderedBody` (Experimental) returns the rendered body in HTML format (in addition to the raw body) for each comment.","schema":{"type":"array","items":{"type":"string"}}},{"name":"start","in":"query","description":"The starting index of the returned comments. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of comments to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the comments, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOCommentDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment?start=0&limit=1\"},\"values\":[{\"_expands\":[\"attachment\",\"renderedBody\"],\"id\":\"1000\",\"body\":\"Hello there\",\"public\":true,\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment/1000\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Create request comment","description":"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.\n\n**[Permissions](#permissions) required**: User has Add Comments permission.\n\n**Request limitations**: Customers can set comments to public visibility only.","operationId":"com.atlassian.servicedesk.api.rest.resource.CommentResource.createRequestComment_post","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to which the comment will be added.","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreateDTO"},"example":{"public":true,"body":"Hello there"}}},"required":true},"responses":{"201":{"description":"Returns the comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentDTO"},"example":"{\"_expands\":[\"attachment\",\"renderedBody\"],\"id\":\"1000\",\"body\":\"Hello there\",\"public\":true,\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment/1000\"}}"}}},"400":{"description":"Returned if the HTTP request is invalid, e.g. missing the required `public`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/comment/{commentId}":{"get":{"tags":["Request"],"summary":"Get request comment by id","description":"This method returns details of a customer request's comment.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.\n\n**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.","operationId":"com.atlassian.servicedesk.api.rest.resource.CommentResource.getRequestCommentById_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request that contains the comment.","required":true,"schema":{"type":"string"}},{"name":"commentId","in":"path","description":"The ID of the comment to retrieve.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"expand","in":"query","description":"A multi-value parameter indicating which properties of the comment to expand:\n\n *  `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](#api-request-issueIdOrKey-attachment-get).)\n *  `renderedBody` (Experimental) returns the rendered body in HTML format (in addition to the raw body) of the comment.","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Returns the comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentDTO"},"example":"{\"_expands\":[\"attachment\",\"renderedBody\"],\"id\":\"1000\",\"body\":\"Hello there\",\"public\":true,\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/2000/comment/1000\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request or comment do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/comment/{commentId}/attachment":{"get":{"tags":["Request"],"summary":"Get comment attachments","description":"This method returns the attachments referenced in a comment.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.\n\n**Response limitations**: Customers can only view public comments, and retrieve their attachements, on requests where they are the reporter or a participant whereas agents can see both internal and public comments.","operationId":"com.atlassian.servicedesk.api.rest.resource.CommentResource.getCommentAttachments_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request that contains the comment.","required":true,"schema":{"type":"string"}},{"name":"commentId","in":"path","description":"The ID of the comment.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"start","in":"query","description":"The starting index of the returned comments. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of comments to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the attachments, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOAttachmentDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/IT-15/comment/1001/attachment?start=0&limit=2\"},\"values\":[{\"filename\":\"screenshot.png\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":23123,\"mimeType\":\"image/png\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10000\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10000/screenshot.png\",\"thumbnail\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/thumbnail/10000/_thumb_10000.png\"}},{\"filename\":\"log.txt\",\"author\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}},\"created\":{\"iso8601\":\"2015-10-09T10:22:00+0700\",\"jira\":\"2015-10-09T10:22:00.000+0700\",\"friendly\":\"Today 10:22 AM\",\"epochMillis\":1444360920000},\"size\":32132,\"mimeType\":\"text/plain\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/attachment/10001\",\"content\":\"https://your-domain.atlassian.net/servicedesk/customershim/secure/attachment/10001/log.txt\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request or the comment do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/notification":{"get":{"tags":["Request"],"summary":"Get subscription status","description":"This method returns the notification subscription status of the user making the request. Use this method to determine if the user is subscribed to a customer request's notifications.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestNotificationResource.getSubscriptionStatus_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be queried for subscription status.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the status of the notification subscription.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestNotificationSubscriptionDTO"},"example":"{\"subscribed\":true}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"put":{"tags":["Request"],"summary":"Subscribe","description":"This method subscribes the user to receiving notifications from a customer request.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestNotificationResource.subscribe_put","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be subscribed to.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Returns if the user was subscribed."},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"},"delete":{"tags":["Request"],"summary":"Unsubscribe","description":"This method unsubscribes the user from notifications from a customer request.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestNotificationResource.unsubscribe_delete","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be unsubscribed from.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Returns if the user was unsubscribed."},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/participant":{"get":{"tags":["Request"],"summary":"Get request participants","description":"This method returns a list of all the participants on a customer request.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestParticipantResource.getRequestParticipants_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be queried for its participants.","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of request types to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the customer request's participants, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOUserDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=0&limit=1\"},\"values\":[{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Add request participants","description":"This method adds participants to a customer request.\n\n**[Permissions](#permissions) required**: Permission to manage participants on the customer request.\n\nNote, participants can be added when creating a customer request using the [request](#api-request-post) resource, by defining the participants in the `requestParticipants` field.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestParticipantResource.addRequestParticipants_post","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to have participants added.","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestParticipantUpdateDTO"},"example":{"accountIds":[],"usernames":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"]}}},"required":true},"responses":{"200":{"description":"Returns the participants added to the customer request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOUserDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=0&limit=1\"},\"values\":[{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}]}"}}},"400":{"description":"Returned if any user to be added as a participant does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"},"delete":{"tags":["Request"],"summary":"Remove request participants","description":"This method removes participants from a customer request.\n\n**[Permissions](#permissions) required**: Permission to manage participants on the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestParticipantResource.removeRequestParticipants_delete","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to have participants removed.","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestParticipantUpdateDTO"},"example":{"accountIds":[],"usernames":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"]}}},"required":true},"responses":{"200":{"description":"Returns the first page of the customer request's participants (after removal of the users).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOUserDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1000/participant?start=0&limit=1\"},\"values\":[{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}]}"}}},"400":{"description":"Returned if any user to be removed as a participant does not exist, is not a participant in the customer request, or is the reporter of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"DELETE"}},"/rest/servicedeskapi/request/{issueIdOrKey}/sla":{"get":{"tags":["Request"],"summary":"Get sla information","description":"This method returns all the SLA records on a customer request. A customer request can have zero or more SLAs. Each SLA can have recordings for zero or more \"completed cycles\" and zero or 1 \"ongoing cycle\". Each cycle includes information on when it started and stopped, and whether it breached the SLA goal.\n\n**[Permissions](#permissions) required**: Agent for the Service Desk containing the queried customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestSlaResource.getSlaInformation_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request whose SLAs will be retrieved.","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of request types to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the SLA records on the customer request, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOSlaInformationDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla?start=0&limit=3\"},\"values\":[{\"name\":\"Time To First Response\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla/10030\"},\"completedCycles\":[{\"startTime\":{\"iso8601\":\"2015-10-09T10:45:23+0700\",\"jira\":\"2015-10-09T10:45:23.000+0700\",\"friendly\":\"Yesterday 10:45 AM\",\"epochMillis\":1444362323000},\"stopTime\":{\"iso8601\":\"2015-10-09T10:52:23+0700\",\"jira\":\"2015-10-09T10:52:23.000+0700\",\"friendly\":\"Yesterday 10:52 AM\",\"epochMillis\":1444362743000},\"breached\":false,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":420000,\"friendly\":\"0h 7m\"},\"remainingTime\":{\"millis\":13980000,\"friendly\":\"3h 233m\"}},{\"startTime\":{\"iso8601\":\"2015-10-10T10:52:23+0700\",\"jira\":\"2015-10-10T10:52:23.000+0700\",\"friendly\":\"Today 10:52 AM\",\"epochMillis\":1444449143000},\"stopTime\":{\"iso8601\":\"2015-10-10T16:15:23+0700\",\"jira\":\"2015-10-10T16:15:23.000+0700\",\"friendly\":\"Today 16:15 PM\",\"epochMillis\":1444468523000},\"breached\":true,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":19380000,\"friendly\":\"5h 323m\"},\"remainingTime\":{\"millis\":-4980000,\"friendly\":\"-1h -83m\"}}],\"ongoingCycle\":{\"startTime\":{\"iso8601\":\"2015-10-10T19:15:23+0700\",\"jira\":\"2015-10-10T19:15:23.000+0700\",\"friendly\":\"Today 19:15 PM\",\"epochMillis\":1444479323000},\"breached\":false,\"paused\":false,\"withinCalendarHours\":false,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":5640000,\"friendly\":\"1h 94m\"},\"remainingTime\":{\"millis\":8760000,\"friendly\":\"2h 146m\"}}},{\"name\":\"Time To Resolution\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla/10040\"},\"completedCycles\":[{\"startTime\":{\"iso8601\":\"2015-10-09T10:45:23+0700\",\"jira\":\"2015-10-09T10:45:23.000+0700\",\"friendly\":\"Yesterday 10:45 AM\",\"epochMillis\":1444362323000},\"stopTime\":{\"iso8601\":\"2015-10-09T20:52:23+0700\",\"jira\":\"2015-10-09T20:52:23.000+0700\",\"friendly\":\"Yesterday 20:52 PM\",\"epochMillis\":1444398743000},\"breached\":false,\"goalDuration\":{\"millis\":72000000,\"friendly\":\"20h 1200m\"},\"elapsedTime\":{\"millis\":36420000,\"friendly\":\"10h 607m\"},\"remainingTime\":{\"millis\":35580000,\"friendly\":\"9h 593m\"}},{\"startTime\":{\"iso8601\":\"2015-10-10T20:52:23+0700\",\"jira\":\"2015-10-10T20:52:23.000+0700\",\"friendly\":\"Today 20:52 PM\",\"epochMillis\":1444485143000},\"stopTime\":{\"iso8601\":\"2015-10-11T02:15:23+0700\",\"jira\":\"2015-10-11T02:15:23.000+0700\",\"friendly\":\"Today 02:15 AM\",\"epochMillis\":1444504523000},\"breached\":true,\"goalDuration\":{\"millis\":72000000,\"friendly\":\"20h 1200m\"},\"elapsedTime\":{\"millis\":19380000,\"friendly\":\"5h 323m\"},\"remainingTime\":{\"millis\":52620000,\"friendly\":\"14h 877m\"}}],\"ongoingCycle\":{\"startTime\":{\"iso8601\":\"2015-10-11T05:15:23+0700\",\"jira\":\"2015-10-11T05:15:23.000+0700\",\"friendly\":\"Today 05:15 AM\",\"epochMillis\":1444515323000},\"breached\":false,\"paused\":false,\"withinCalendarHours\":false,\"goalDuration\":{\"millis\":72000000,\"friendly\":\"20h 1200m\"},\"elapsedTime\":{\"millis\":5640000,\"friendly\":\"1h 94m\"},\"remainingTime\":{\"millis\":66360000,\"friendly\":\"18h 1106m\"}}},{\"name\":\"Time To Retrospective\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla/10050\"},\"completedCycles\":[{\"startTime\":{\"iso8601\":\"2015-10-09T10:45:23+0700\",\"jira\":\"2015-10-09T10:45:23.000+0700\",\"friendly\":\"Yesterday 10:45 AM\",\"epochMillis\":1444362323000},\"stopTime\":{\"iso8601\":\"2015-10-10T10:52:23+0700\",\"jira\":\"2015-10-10T10:52:23.000+0700\",\"friendly\":\"Yesterday 10:52 AM\",\"epochMillis\":1444449143000},\"breached\":false,\"goalDuration\":{\"millis\":144000000,\"friendly\":\"40h 2400m\"},\"elapsedTime\":{\"millis\":86820000,\"friendly\":\"24h 1447m\"},\"remainingTime\":{\"millis\":57180000,\"friendly\":\"15h 953m\"}},{\"startTime\":{\"iso8601\":\"2015-10-11T10:52:23+0700\",\"jira\":\"2015-10-11T10:52:23.000+0700\",\"friendly\":\"Today 10:52 AM\",\"epochMillis\":1444535543000},\"stopTime\":{\"iso8601\":\"2015-10-11T16:15:23+0700\",\"jira\":\"2015-10-11T16:15:23.000+0700\",\"friendly\":\"Today 16:15 PM\",\"epochMillis\":1444554923000},\"breached\":true,\"goalDuration\":{\"millis\":144000000,\"friendly\":\"40h 2400m\"},\"elapsedTime\":{\"millis\":19380000,\"friendly\":\"5h 323m\"},\"remainingTime\":{\"millis\":124620000,\"friendly\":\"34h 2077m\"}}],\"ongoingCycle\":{\"startTime\":{\"iso8601\":\"2015-10-11T19:15:23+0700\",\"jira\":\"2015-10-11T19:15:23.000+0700\",\"friendly\":\"Today 19:15 PM\",\"epochMillis\":1444565723000},\"breached\":false,\"paused\":false,\"withinCalendarHours\":false,\"goalDuration\":{\"millis\":144000000,\"friendly\":\"40h 2400m\"},\"elapsedTime\":{\"millis\":5640000,\"friendly\":\"1h 94m\"},\"remainingTime\":{\"millis\":138360000,\"friendly\":\"38h 2306m\"}}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:jira-work"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/sla/{slaMetricId}":{"get":{"tags":["Request"],"summary":"Get sla information by id","description":"This method returns the details for an SLA on a customer request.\n\n**[Permissions](#permissions) required**: Agent for the Service Desk containing the queried customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestSlaResource.getSlaInformationById_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request whose SLAs will be retrieved.","required":true,"schema":{"type":"string"}},{"name":"slaMetricId","in":"path","description":"The ID or key of the SLAs metric to be retrieved.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Returns the SLA record, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlaInformationDTO"},"example":"{\"name\":\"Time To First Response\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/101102/sla/10030\"},\"completedCycles\":[{\"startTime\":{\"iso8601\":\"2015-10-09T10:45:23+0700\",\"jira\":\"2015-10-09T10:45:23.000+0700\",\"friendly\":\"Yesterday 10:45 AM\",\"epochMillis\":1444362323000},\"stopTime\":{\"iso8601\":\"2015-10-09T10:52:23+0700\",\"jira\":\"2015-10-09T10:52:23.000+0700\",\"friendly\":\"Yesterday 10:52 AM\",\"epochMillis\":1444362743000},\"breached\":false,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":420000,\"friendly\":\"0h 7m\"},\"remainingTime\":{\"millis\":13980000,\"friendly\":\"3h 233m\"}},{\"startTime\":{\"iso8601\":\"2015-10-10T10:52:23+0700\",\"jira\":\"2015-10-10T10:52:23.000+0700\",\"friendly\":\"Today 10:52 AM\",\"epochMillis\":1444449143000},\"stopTime\":{\"iso8601\":\"2015-10-10T16:15:23+0700\",\"jira\":\"2015-10-10T16:15:23.000+0700\",\"friendly\":\"Today 16:15 PM\",\"epochMillis\":1444468523000},\"breached\":true,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":19380000,\"friendly\":\"5h 323m\"},\"remainingTime\":{\"millis\":-4980000,\"friendly\":\"-1h -83m\"}}],\"ongoingCycle\":{\"startTime\":{\"iso8601\":\"2015-10-10T19:15:23+0700\",\"jira\":\"2015-10-10T19:15:23.000+0700\",\"friendly\":\"Today 19:15 PM\",\"epochMillis\":1444479323000},\"breached\":false,\"paused\":false,\"withinCalendarHours\":false,\"goalDuration\":{\"millis\":14400000,\"friendly\":\"4h 240m\"},\"elapsedTime\":{\"millis\":5640000,\"friendly\":\"1h 94m\"},\"remainingTime\":{\"millis\":8760000,\"friendly\":\"2h 146m\"}}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:jira-work"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/status":{"get":{"tags":["Request"],"summary":"Get customer request status","description":"This method returns a list of all the statuses a customer Request has achieved. A status represents the state of an issue in its workflow. An issue can have one active status only. The list returns the status history in chronological order, most recent (current) status first.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestStatusResource.getCustomerRequestStatus_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request to be retrieved.","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the customer request's status history, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOCustomerRequestStatusDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1/status?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1/status?start=0&limit=3\"},\"values\":[{\"status\":\"Waiting for Customer\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:05:00+0700\",\"jira\":\"2015-10-08T14:05:00.000+0700\",\"friendly\":\"Today 14:05 PM\",\"epochMillis\":1444287900000}},{\"status\":\"Waiting for Support\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:01:00+0700\",\"jira\":\"2015-10-08T14:01:00.000+0700\",\"friendly\":\"Today 14:01 PM\",\"epochMillis\":1444287660000}},{\"status\":\"Waiting for Customer\",\"statusDate\":{\"iso8601\":\"2015-10-08T14:00:00+0700\",\"jira\":\"2015-10-08T14:00:00.000+0700\",\"friendly\":\"Today 14:00 PM\",\"epochMillis\":1444287600000}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request is not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/request/{issueIdOrKey}/transition":{"get":{"tags":["Request"],"summary":"Get customer transitions","description":"This method returns a list of transitions, the workflow processes that moves a customer request from one status to another, that the user can perform on a request. Use this method to provide a user with a list if the actions they can take on a customer request.\n\n**[Permissions](#permissions) required**: Permission to view the customer request.","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerTransitionResource.getCustomerTransitions_get","parameters":[{"name":"issueIdOrKey","in":"path","description":"The ID or key of the customer request whose transitions will be retrieved.","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the transitions available to the user on the customer request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOCustomerTransitionDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1/transition?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/request/1/transition?start=0&limit=2\"},\"values\":[{\"id\":\"1\",\"name\":\"Close Request\"},{\"id\":\"2\",\"name\":\"Escalate Request\"}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Perform customer transition","description":"This method performs a customer transition for a given request and transition. An optional comment can be included to provide a reason for the transition.\n\n**[Permissions](#permissions) required**: The user must be able to view the request and have the Transition Issues permission. If a comment is passed the user must have the Add Comments permission.","operationId":"com.atlassian.servicedesk.api.rest.resource.CustomerTransitionResource.performCustomerTransition_post","parameters":[{"name":"issueIdOrKey","in":"path","description":"ID or key of the issue to transition","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerTransitionExecutionDTO"},"example":{"id":"1","additionalComment":{"body":"I have fixed the problem."}}}},"required":true},"responses":{"204":{"description":"Returned if the request is transitioned."},"400":{"description":"Returned if the transition ID is invalid or the comment is too long.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/request/{requestIdOrKey}/feedback":{"get":{"tags":["Request"],"summary":"Get feedback","description":"This method retrieves a feedback of a request using it's `requestKey` or `requestId`\n\n**[Permissions](#permissions) required**: User has view request permissions.","operationId":"com.atlassian.servicedesk.api.rest.resource.CSATFeedbackPublicResource.getFeedback_get","parameters":[{"name":"requestIdOrKey","in":"path","description":"The id or the key of the request to post the feedback on","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CSATFeedbackFullDTO"},"example":"{\"type\":\"csat\",\"rating\":4,\"comment\":{\"body\":\"Great work!\"}}"}}},"400":{"description":"Returned if the HTTP request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if no logged in user/app.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user/app does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-experimental":true,"x-atlassian-connect-scope":"READ"},"post":{"tags":["Request"],"summary":"Post feedback","description":"This method adds a feedback on an request using it's `requestKey` or `requestId`\n\n**[Permissions](#permissions) required**: User must be the reporter or an Atlassian Connect app.","operationId":"com.atlassian.servicedesk.api.rest.resource.CSATFeedbackPublicResource.postFeedback_post","parameters":[{"name":"requestIdOrKey","in":"path","description":"The id or the key of the request to post the feedback on","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"The feedback to be added on the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CSATFeedbackFullDTO"},"example":{"rating":4,"comment":{"body":"Great work!"},"type":"csat"}}},"required":true},"responses":{"201":{"description":"Returns the comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CSATFeedbackFullDTO"},"example":"{\"type\":\"csat\",\"rating\":4,\"comment\":{\"body\":\"Great work!\"}}"}}},"400":{"description":"Returned if the HTTP request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if no logged in user/app.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user/app does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-experimental":true,"x-atlassian-connect-scope":"WRITE"},"delete":{"tags":["Request"],"summary":"Delete feedback","description":"This method deletes the feedback of request using it's `requestKey` or `requestId`\n\n**[Permissions](#permissions) required**: User must be the reporter or an Atlassian Connect app.","operationId":"com.atlassian.servicedesk.api.rest.resource.CSATFeedbackPublicResource.deleteFeedback_delete","parameters":[{"name":"requestIdOrKey","in":"path","description":"The id or the key of the request to post the feedback on","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No content.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Returned if no logged in user/app.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user/app does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the customer request does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-experimental":true,"x-atlassian-connect-scope":"DELETE"}},"/rest/servicedeskapi/requesttype":{"get":{"tags":["Requesttype"],"summary":"Get all request types","description":"This method returns all customer request types used in the Jira Service Desk instance, optionally filtered by a query string.\n\nUse [servicedeskapi/servicedesk/\\{serviceDeskId\\}/requesttype](#api-servicedesk-serviceDeskId-requesttype-get) to find the customer request types supported by a specific service desk.\n\nThe returned list of customer request types can be filtered using the `query` parameter. The parameter is matched against the customer request types' `name` or `description`. For example, searching for \"Install\", \"Inst\", \"Equi\", or \"Equipment\" will match a customer request type with the *name* \"Equipment Installation Request\".\n\n**[Permissions](#permissions) required**: Any","operationId":"com.atlassian.servicedesk.api.rest.resource.GlobalRequestTypeResource.getAllRequestTypes_get","parameters":[{"name":"searchQuery","in":"query","description":"String to be used to filter the results.","schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"expand","in":"query","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Returns the request types, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTORequestTypeDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=0&limit=3\"},\"values\":[{\"_expands\":[],\"id\":\"11001\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001\"},\"name\":\"Get IT Help\",\"description\":\"Get IT Help\",\"helpText\":\"Please tell us clearly the problem you have within 100 words.\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"12\"],\"icon\":{\"id\":\"12345\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12345\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12345\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12345\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12345\"}}}},{\"_expands\":[],\"id\":\"11002\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11002\"},\"name\":\"Request a new account\",\"description\":\"Request a new account\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"13\",\"14\"],\"icon\":{\"id\":\"12346\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12346\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12346\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12346\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12346\"}}}},{\"_expands\":[],\"id\":\"11003\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11003\"},\"name\":\"Hardware request\",\"description\":\"Request a hardware support\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"13\"],\"icon\":{\"id\":\"12347\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12347\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12347\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12347\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12347\"}}}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-experimental":true,"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk":{"get":{"tags":["Servicedesk"],"summary":"Get service desks","description":"This method returns all the service desks in the Jira Service Desk instance that the user has permission to access. Use this method where you need a list of service desks or need to locate a service desk by name or keyword.\n\n**[Permissions](#permissions) required**: Any","operationId":"com.atlassian.servicedesk.api.rest.resource.ServiceDeskResource.getServiceDesks_get","parameters":[{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the service desks, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOServiceDeskDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk?start=0&limit=3\"},\"values\":[{\"id\":\"10001\",\"projectId\":\"11001\",\"projectName\":\"IT Help Desk\",\"projectKey\":\"ITH\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001\"}},{\"id\":\"10002\",\"projectId\":\"11002\",\"projectName\":\"HR Self Serve Desk\",\"projectKey\":\"HR\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10002\"}},{\"id\":\"10003\",\"projectId\":\"11003\",\"projectName\":\"Foundation Leave\",\"projectKey\":\"FL\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10003\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}":{"get":{"tags":["Servicedesk"],"summary":"Get service desk by id","description":"This method returns a service desk. Use this method to get service desk details whenever your application component is passed a service desk ID but needs to display other service desk details.\n\n**[Permissions](#permissions) required**: Permission to access the Service Desk. For example, being the Service Desk's Administrator or one of its Agents or Users.","operationId":"com.atlassian.servicedesk.api.rest.resource.ServiceDeskResource.getServiceDeskById_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk to return. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Returns the requested service desk.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceDeskDTO"},"example":"{\"id\":\"10001\",\"projectId\":\"11001\",\"projectName\":\"IT Help Desk\",\"projectKey\":\"ITH\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/attachTemporaryFile":{"post":{"tags":["Servicedesk"],"summary":"Attach temporary file","description":"This method adds one or more temporary attachments to a service desk, which can then be permanently attached to a customer request using [servicedeskapi/request/\\{issueIdOrKey\\}/attachment](#api-request-issueIdOrKey-attachment-post).\n\n**Note**: It is possible for a service desk administrator to turn off the ability to add attachments to a service desk.\n\nThis method expects a multipart request. The media-type multipart/form-data is defined in RFC 1867. Most client libraries have classes that make dealing with multipart posts simple. For instance, in Java the Apache HTTP Components library provides [MultiPartEntity](http://hc.apache.org/httpcomponents-client-ga/httpmime/apidocs/org/apache/http/entity/mime/MultipartEntity.html).\n\nBecause this method accepts multipart/form-data, it has XSRF protection on it. This means you must submit a header of X-Atlassian-Token: no-check with the request or it will be blocked.\n\nThe name of the multipart/form-data parameter that contains the attachments must be `file`.\n\nFor example, to upload a file called `myfile.txt` in the Service Desk with ID 10001 use\n\n    curl -D- -u customer:customer -X POST -H \"X-ExperimentalApi: opt-in\" -H \"X-Atlassian-Token: no-check\" -F \"file=@myfile.txt\" https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001/attachTemporaryFile\n\n**[Permissions](#permissions) required**: Permission to add attachments in this Service Desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.TemporaryFileResource.attachTemporaryFile_post","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the Service Desk to which the file will be attached. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"description":"The attachments in a RFC 1867 multipart/form-data format.","content":{"multipart/form-data":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Returns if the file(s) were attached.","content":{"application/json":{"example":"{\"temporaryAttachments\":[{\"temporaryAttachmentId\":\"temp8186986881700442965\",\"fileName\":\"atlassian.png\"},{\"temporaryAttachmentId\":\"temp589064256337898328\",\"fileName\":\"readme.txt\"}]}"}}},"400":{"description":"Returned if the attachments are not valid, or exceed the maximum configured attachment size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["write:servicedesk-request"]}],"x-atlassian-connect-scope":"WRITE"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer":{"get":{"tags":["Servicedesk"],"summary":"Get customers","description":"This method returns a list of the customers on a service desk.\n\nThe returned list of customers can be filtered using the `query` parameter. The parameter is matched against customers' `displayName`, `name`, or `email`. For example, searching for \"John\", \"Jo\", \"Smi\", or \"Smith\" will match a user with display name \"John Smith\".\n\n**[Permissions](#permissions) required**: Permission to view this Service Desk's customers.","operationId":"com.atlassian.servicedesk.api.rest.resource.ServiceDeskCustomerResource.getCustomers_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk the customer list should be returned from. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"query","in":"query","description":"The string used to filter the customer list.","schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of users to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the service desk's customer list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOUserDTO"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/customer?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/customer?start=0&limit=1\"},\"values\":[{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-experimental":true,"x-atlassian-connect-scope":"READ"},"post":{"tags":["Servicedesk"],"summary":"Add customers","description":"Adds one or more customers to a service desk. If any of the passed customers are associated with the service desk, no changes will be made for those customers and the resource returns a 204 success code.\n\n**[Permissions](#permissions) required**: Service desk administrator","operationId":"com.atlassian.servicedesk.api.rest.resource.ServiceDeskCustomerResource.addCustomers_post","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk the customer list should be returned from. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceDeskCustomerDTO"},"example":{"accountIds":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"],"usernames":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"]}}},"required":true},"responses":{"204":{"description":"Returned if all the customers were added to the service desk or were already associated with the service desk."},"400":{"description":"Returned if any of the customers do not exist. Note that any valid customers are added, but no confirmation is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"WRITE"},"delete":{"tags":["Servicedesk"],"summary":"Remove customers","description":"This method removes one or more customers from a service desk. The service desk must have closed access. If any of the passed customers are not associated with the service desk, no changes will be made for those customers and the resource returns a 204 success code.\n\n**[Permissions](#permissions) required**: Services desk administrator","operationId":"com.atlassian.servicedesk.api.rest.resource.ServiceDeskCustomerResource.removeCustomers_delete","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk the customers should be removed from. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceDeskCustomerDTO"},"example":{"accountIds":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"],"usernames":["qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae","qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"]}}},"required":true},"responses":{"204":{"description":"Returned if the customers were removed from the service desk, or any of the customers were not associated with the service desk."},"400":{"description":"Returned if the service desk has public signup or open access enabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/knowledgebase/article":{"get":{"tags":["Servicedesk"],"summary":"Get articles","description":"Returns articles which match the given query and belong to the knowledge base linked to the service desk.\n\n**[Permissions](#permissions) required**: Permission to access the service desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.KBServiceDeskResource.getArticles_get","parameters":[{"name":"serviceDeskId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"query","in":"query","description":"The string used to filter the articles (required).","schema":{"type":"string"}},{"name":"highlight","in":"query","description":"If set to true matching query term in the title and excerpt will be highlighted using the \\{@code","schema":{"type":"boolean","default":false}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the articles, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOArticleDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk//knowledgebase/article?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk//knowledgebase/article?start=0&limit=2\"},\"values\":[{\"title\":\"Stolen computer\",\"excerpt\":\"assuming your computer was stolen\",\"source\":{\"type\":\"confluence\",\"pageId\":\"8786177\",\"spaceKey\":\"IT\"},\"content\":{\"iframeSrc\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8786177\"}},{\"title\":\"Upgrading computer\",\"excerpt\":\"each computer older then 3 years can be upgraded\",\"source\":{\"type\":\"confluence\",\"pageId\":\"8785228\",\"spaceKey\":\"IT\"},\"content\":{\"iframeSrc\":\"https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8785228\"}}]}"}}},"400":{"description":"Returned if the request is invalid, for example: missing query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-experimental":true,"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization":{"get":{"tags":["Organization"],"summary":"Get organizations","description":"This method returns a list of all organizations associated with a service desk.\n\n**[Permissions](#permissions) required**: Service desk's agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationServiceDeskResource.getOrganizations_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk from which the organization list will be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the requested organizations list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOOrganizationDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001/organization?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001/organization?start=0&limit=3\"},\"values\":[{\"id\":\"1\",\"name\":\"Charlie Cakes Franchises\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/1\"}},{\"id\":\"2\",\"name\":\"Atlas Coffee Co\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/2\"}},{\"id\":\"3\",\"name\":\"The Adjustment Bureau\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/organization/3\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Organization"],"summary":"Add organization","description":"This method adds an organization to a service desk. If the organization ID is already associated with the service desk, no change is made and the resource returns a 204 success code.\n\n**[Permissions](#permissions) required**: Service desk's agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationServiceDeskResource.addOrganization_post","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk to which the organization will be added. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationServiceDeskUpdateDTO"},"example":{"organizationId":1}}},"required":true},"responses":{"204":{"description":"Returned if the organization was added or the organization was already associated with the service desk."},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or organization do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"WRITE"},"delete":{"tags":["Organization"],"summary":"Remove organization","description":"This method removes an organization from a service desk. If the organization ID does not match an organization associated with the service desk, no change is made and the resource returns a 204 success code.\n\n**[Permissions](#permissions) required**: Service desk's agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.OrganizationServiceDeskResource.removeOrganization_delete","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk from which the organization will be removed. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationServiceDeskUpdateDTO"},"example":{"organizationId":1}}},"required":true},"responses":{"204":{"description":"Returned if the organization was removed from the service desk or no such organization was associated with the service desk."},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or organization do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:servicedesk-customer"]}],"x-atlassian-connect-scope":"DELETE"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/queue":{"get":{"tags":["Servicedesk"],"summary":"Get queues","description":"This method returns the queues in a service desk. To include a customer request count for each queue (in the `issueCount` field) in the response, set the query parameter `includeCount` to true (its default is false).\n\n**[Permissions](#permissions) required**: service desk's Agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.QueueResource.getQueues_get","parameters":[{"name":"serviceDeskId","in":"path","description":"ID of the service desk whose queues will be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"includeCount","in":"query","description":"Specifies whether to include each queue's customer request (issue) count in the response.","schema":{"type":"boolean","default":false}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the queues of the service desk, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOQueueDTO"},"example":"{\"_expands\":[],\"size\":2,\"start\":2,\"limit\":2,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue?start=4&limit=2\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue?start=0&limit=2\"},\"values\":[{\"id\":\"10\",\"name\":\"Unassigned issues\",\"jql\":\"project = SD AND assignee is EMPTY AND resolution = Unresolved ORDER BY \\\"Time to resolution\\\" ASC\",\"fields\":[\"issuetype\",\"issuekey\",\"summary\",\"created\",\"reporter\",\"duedate\"],\"issueCount\":10,\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10\"}},{\"id\":\"20\",\"name\":\"Assigned to me\",\"jql\":\"project = SD AND assignee = currentUser() AND resolution = Unresolved ORDER BY \\\"Time to resolution\\\" ASC\",\"fields\":[\"issuetype\",\"issuekey\",\"summary\",\"created\",\"reporter\",\"duedate\"],\"issueCount\":10,\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/20\"}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:jira-work"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/queue/{queueId}":{"get":{"tags":["Servicedesk"],"summary":"Get queue","description":"This method returns a specific queues in a service desk. To include a customer request count for the queue (in the `issueCount` field) in the response, set the query parameter `includeCount` to true (its default is false).\n\n**[Permissions](#permissions) required**: service desk's Agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.QueueResource.getQueue_get","parameters":[{"name":"serviceDeskId","in":"path","description":"ID of the service desk whose queues will be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"queueId","in":"path","description":"ID of the required queue.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"includeCount","in":"query","description":"Specifies whether to include each queue's customer request (issue) count in the response.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Returns the specific queue of the service desk.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueDTO"},"example":"{\"id\":\"20\",\"name\":\"Assigned to me\",\"jql\":\"project = SD AND assignee = currentUser() AND resolution = Unresolved ORDER BY \\\"Time to resolution\\\" ASC\",\"fields\":[\"issuetype\",\"issuekey\",\"summary\",\"created\",\"reporter\",\"duedate\"],\"issueCount\":10,\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/20\"}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:jira-work"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/queue/{queueId}/issue":{"get":{"tags":["Servicedesk"],"summary":"Get issues in queue","description":"This method returns the customer requests in a queue. Only fields that the queue is configured to show are returned. For example, if a queue is configured to show description and due date, then only those two fields are returned for each customer request in the queue.\n\n**[Permissions](#permissions) required**: Service desk's agent.","operationId":"com.atlassian.servicedesk.api.rest.resource.QueueResource.getIssuesInQueue_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk containing the queue to be queried. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"queueId","in":"path","description":"The ID of the queue whose customer requests will be returned.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 50. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the customer requests belonging to the queue, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTOIssueBean"},"example":"{\"_expands\":[],\"size\":1,\"start\":1,\"limit\":1,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10/issue?start=2&limit=1\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10/issue?start=0&limit=1\"},\"values\":[{\"id\":\"10001\",\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/rest/api/2/issue/10001\",\"key\":\"SD-1\",\"fields\":{\"summary\":\"My keyboard is broken\",\"issuetype\":{\"self\":\"https://your-domain.atlassian.net/rest/api/2/issuetype/13\",\"id\":\"13\",\"description\":\"For general IT problems and questions. Created by Jira Service Desk.\",\"iconUrl\":\"https://your-domain.atlassian.net/servicedesk/issue-type-icons?icon=it-help\",\"name\":\"IT Help\",\"subtask\":false,\"avatarId\":10002},\"duedate\":\"2015-11-11T14:17:13.000+0700\",\"created\":\"2015-11-09T14:17:13.000+0700\",\"reporter\":{\"accountId\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"name\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"key\":\"qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"emailAddress\":\"fred@example.com\",\"displayName\":\"Fred F. User\",\"active\":true,\"timeZone\":\"Australia/Sydney\",\"_links\":{\"jiraRest\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\",\"avatarUrls\":{\"48x48\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue\",\"24x24\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue\",\"16x16\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue\",\"32x32\":\"https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue\"},\"self\":\"https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b\"}}}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or the queue do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:jira-work"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype":{"get":{"tags":["Servicedesk"],"summary":"Get request types","description":"This method returns all customer request types from a service desk. There are two parameters for filtering the returned list:\n\n *  `groupId` which filters the results to items in the customer request type group.\n *  `searchQuery` which is matched against request types' `name` or `description`. For example, the strings \"Install\", \"Inst\", \"Equi\", or \"Equipment\" will match a request type with the *name* \"Equipment Installation Request\".\n\n**[Permissions](#permissions) required**: Permission to access the service desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypeResource.getRequestTypes_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk whose customer request types are to be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"groupId","in":"query","description":"Filters results to those in a customer request type group.","schema":{"type":"integer","format":"int32"}},{"name":"expand","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"searchQuery","in":"query","description":"The string to be used to filter the results.","schema":{"type":"string"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the requested customer request types, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTORequestTypeDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=0&limit=3\"},\"values\":[{\"_expands\":[],\"id\":\"11001\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001\"},\"name\":\"Get IT Help\",\"description\":\"Get IT Help\",\"helpText\":\"Please tell us clearly the problem you have within 100 words.\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"12\"],\"icon\":{\"id\":\"12345\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12345\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12345\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12345\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12345\"}}}},{\"_expands\":[],\"id\":\"11002\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11002\"},\"name\":\"Request a new account\",\"description\":\"Request a new account\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"13\",\"14\"],\"icon\":{\"id\":\"12346\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12346\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12346\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12346\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12346\"}}}},{\"_expands\":[],\"id\":\"11003\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11003\"},\"name\":\"Hardware request\",\"description\":\"Request a hardware support\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"13\"],\"icon\":{\"id\":\"12347\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12347\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12347\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12347\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12347\"}}}}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"},"post":{"tags":["Servicedesk"],"summary":"Create request type","description":"This method enables a customer request type to be added to a service desk based on an issue type. Note that not all customer request type fields can be specified in the request and these fields are given the following default values:\n\n *  Request type icon is given the question mark icon.\n *  Request type groups is left empty, which means this customer request type will not be visible on the [customer portal](https://confluence.atlassian.com/servicedeskcloud/configuring-the-customer-portal-732528918.html).\n *  Request type status mapping is left empty, so the request type has no custom status mapping but inherits the status map from the issue type upon which it is based.\n *  Request type field mapping is set to show the required fields as specified by the issue type used to create the customer request type.\n\n  \nThese fields can be updated by a service desk administrator using the **Request types** option in **Project settings**.  \nRequest Types are created in next-gen projects by creating Issue Types. Please use the Jira Cloud Platform Create issue type endpoint instead.\n\n**[Permissions](#permissions) required**: Service desk's administrator","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypeResource.createRequestType_post","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk where the customer request type is to be created. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestTypeCreateDTO"},"example":{"issueTypeId":"12345","helpText":"Please tell us clearly the problem you have within 100 words.","name":"Get IT Help","description":"Get IT Help"}}},"required":true},"responses":{"200":{"description":"Returns the customer request type created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestTypeDTO"},"example":"{\"_expands\":[],\"id\":\"11001\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001\"},\"name\":\"Get IT Help\",\"description\":\"Get IT Help\",\"helpText\":\"Please tell us clearly the problem you have within 100 words.\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"12\"],\"icon\":{\"id\":\"12345\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12345\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12345\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12345\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12345\"}}}}"}}},"400":{"description":"Returned if the customer request type name is empty.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or issue type do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"x-experimental":true,"x-atlassian-connect-scope":"PROJECT_ADMIN"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}":{"get":{"tags":["Servicedesk"],"summary":"Get request type by id","description":"This method returns a customer request type from a service desk.\n\n**[Permissions](#permissions) required**: Permission to access the service desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypeResource.getRequestTypeById_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk whose customer request type is to be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"path","description":"The ID of the customer request type to be returned.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"expand","in":"query","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Returns the customer request type item.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestTypeDTO"},"example":"{\"_expands\":[],\"id\":\"11001\",\"_links\":{\"self\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001\"},\"name\":\"Get IT Help\",\"description\":\"Get IT Help\",\"helpText\":\"Please tell us clearly the problem you have within 100 words.\",\"issueTypeId\":\"12345\",\"serviceDeskId\":\"28\",\"groupIds\":[\"12\"],\"icon\":{\"id\":\"12345\",\"_links\":{\"iconUrls\":{\"48x48\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=large&avatarId=12345\",\"24x24\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=small&avatarId=12345\",\"16x16\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=xsmall&avatarId=12345\",\"32x32\":\"https://your-domain.atlassian.net/secure/viewavatar?avatarType=SD_REQTYPE&size=medium&avatarId=12345\"}}}}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or customer request type do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/field":{"get":{"tags":["Servicedesk"],"summary":"Get request type fields","description":"This method returns the fields for a service desk's customer request type.\n\nAlso, the following information about the user's permissions for the request type is returned:\n\n *  `canRaiseOnBehalfOf` returns `true` if the user has permission to raise customer requests on behalf of other customers. Otherwise, returns `false`.\n *  `canAddRequestParticipants` returns `true` if the user can add customer request participants. Otherwise, returns `false`.\n\n**[Permissions](#permissions) required**: Permission to view the Service Desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypeFieldResource.getRequestTypeFields_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk containing the request types whose fields are to be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"path","description":"The ID of the request types whose fields are to be returned.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the request type's fields and user permission details, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerRequestCreateMetaDTO"},"example":"{\"requestTypeFields\":[{\"fieldId\":\"summary\",\"name\":\"What do you need?\",\"required\":true,\"validValues\":[],\"jiraSchema\":{\"type\":\"string\",\"system\":\"summary\"}},{\"fieldId\":\"customfield_10000\",\"name\":\"Nominee\",\"required\":true,\"validValues\":[],\"jiraSchema\":{\"type\":\"user\",\"custom\":\"com.atlassian.jira.plugin.system.customfieldtypes:userpicker\",\"customId\":10000}},{\"fieldId\":\"customfield_10001\",\"name\":\"Gifts\",\"required\":true,\"validValues\":[{\"value\":\"10000\",\"label\":\"Bottle of Wine\",\"children\":[]},{\"value\":\"10001\",\"label\":\"Threadless Voucher\",\"children\":[]},{\"value\":\"10002\",\"label\":\"2 Movie Tickets\",\"children\":[]}],\"jiraSchema\":{\"type\":\"string\",\"custom\":\"com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons\",\"customId\":10001}}],\"canRaiseOnBehalfOf\":true,\"canAddRequestParticipants\":true}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk or request type do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property":{"get":{"tags":["Servicedesk"],"summary":"Get properties keys","description":"Returns the keys of all properties for a request type.\n\nProperties for a Request Type in next-gen are stored as Issue Type properties and therefore the keys of all properties for a request type are also available by calling the Jira Cloud Platform [Get issue type property keys](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-get) endpoint.\n\n**[Permissions](#permissions) required**: The user must have permission to view the request type.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypePropertyResource.getPropertiesKeys_get","parameters":[{"name":"requestTypeId","in":"path","description":"The ID of the request type for which keys will be retrieved.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"serviceDeskId","in":"path","description":"The ID of the service desk which contains the request type. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returned if the request type was found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyKeys"},"example":"{\"keys\":[{\"self\":\"/rest/servicedeskapi/servicedesk/1/requestType/2/property/propertyKey\",\"key\":\"requestType.attributes\"}]}"}}},"400":{"description":"Returned if the request type ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the request type does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property/{propertyKey}":{"get":{"tags":["Servicedesk"],"summary":"Get property","description":"Returns the value of the property from a request type.\n\nProperties for a Request Type in next-gen are stored as Issue Type properties and therefore also available by calling the Jira Cloud Platform [Get issue type property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-get) endpoint.\n\n**[Permissions](#permissions) required**: User must have permission to view the request type.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypePropertyResource.getProperty_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk which contains the request type. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"path","description":"The ID of the request type from which the property will be retrieved.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"propertyKey","in":"path","description":"The key of the property to return.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returned if the request type property was returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityProperty"},"example":"{\"key\":\"organization.attributes\",\"value\":{\"priority\":\"high\",\"color\":\"green\"}}"}}},"400":{"description":"Returned if the request type ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the request type or property do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"},"put":{"tags":["Servicedesk"],"summary":"Set property","description":"Sets the value of a request type property. Use this resource to store custom data against a request type.\n\nProperties for a Request Type in next-gen are stored as Issue Type properties and therefore can also be set by calling the Jira Cloud Platform [Set issue type property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-put) endpoint.\n\n**[Permissions](#permissions) required**: Jira project administrator with a Jira Service Desk agent license.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypePropertyResource.setProperty_put","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk which contains the request type. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"path","description":"The ID of the request type on which the property will be set.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"propertyKey","in":"path","description":"The key of the request type property. The maximum length of the key is 255 bytes.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returned if the request type property is updated.","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Returned if the request type property is created.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Returned if the request type ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the calling user doesn't have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the request type does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:jira-project"]}],"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"},"delete":{"tags":["Servicedesk"],"summary":"Delete property","description":"Removes a property from a request type.\n\nProperties for a Request Type in next-gen are stored as Issue Type properties and therefore can also be deleted by calling the Jira Cloud Platform [Delete issue type property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-delete) endpoint.\n\n**[Permissions](#permissions) required**: Jira project administrator with a Jira Service Desk agent license.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypePropertyResource.deleteProperty_delete","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk which contains the request type. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"requestTypeId","in":"path","description":"The ID of the request type for which the property will be removed.","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"propertyKey","in":"path","description":"The key of the property to remove.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Returned if the request type property was removed."},"400":{"description":"Returned if the request type ID is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the calling user doesn't have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the request type or property do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["manage:jira-project"]}],"x-experimental":true,"x-atlassian-connect-scope":"INACCESSIBLE"}},"/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttypegroup":{"get":{"tags":["Servicedesk"],"summary":"Get request type groups","description":"This method returns a service desk's customer request type groups. Jira Service Desk administrators can arrange the customer request type groups in an arbitrary order for display on the customer portal; the groups are returned in this order.\n\n**[Permissions](#permissions) required**: Permission to view the service desk.","operationId":"com.atlassian.servicedesk.api.rest.resource.RequestTypeGroupResource.getRequestTypeGroups_get","parameters":[{"name":"serviceDeskId","in":"path","description":"The ID of the service desk whose customer request type groups are to be returned. This can alternatively be a [project identifier.](#project-identifiers)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"start","in":"query","description":"The starting index of the returned objects. Base index: 0. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum number of items to return per page. Default: 100. See the [Pagination](#pagination) section for more details.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Returns the service desk's customer request type groups, on the specified page of the results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedDTORequestTypeGroupDTO"},"example":"{\"_expands\":[],\"size\":3,\"start\":3,\"limit\":3,\"isLastPage\":false,\"_links\":{\"base\":\"https://your-domain.atlassian.net/rest/servicedeskapi\",\"context\":\"context\",\"next\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk//requesttypegroup?start=6&limit=3\",\"prev\":\"https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk//requesttypegroup?start=0&limit=3\"},\"values\":[{\"id\":\"12\",\"name\":\"Common Requests\"},{\"id\":\"13\",\"name\":\"Logins and Accounts\"},{\"id\":\"14\",\"name\":\"Servers and Infrastructure\"}]}"}}},"401":{"description":"Returned if the user is not logged in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Returned if the user does not have permission to complete this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Returned if the service desk does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false,"security":[{"OAuth2":["read:servicedesk-request"]}],"x-atlassian-connect-scope":"READ"}}},"components":{"schemas":{"IncludedFields":{"type":"object","properties":{"included":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"actuallyIncluded":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"excluded":{"uniqueItems":true,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"CustomerRequestActionsDTO":{"type":"object","properties":{"addAttachment":{"description":"Action of adding attachments to a request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestActionDTO"}]},"addComment":{"description":"Action of adding comments to a request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestActionDTO"}]},"addParticipant":{"description":"Action of adding participants to a request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestActionDTO"}]},"removeParticipant":{"description":"Action of removing participants from a request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestActionDTO"}]}},"additionalProperties":false},"PagedDTOOrganizationDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/OrganizationDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"FieldMetadata":{"required":["key","name","operations","required"],"type":"object","properties":{"required":{"type":"boolean","description":"Indicates whether the field is required.","readOnly":true},"schema":{"description":"The data type of the field.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/JsonTypeBean"}]},"name":{"type":"string","description":"The name of the field.","readOnly":true},"key":{"type":"string","description":"The key of the field.","readOnly":true},"autoCompleteUrl":{"type":"string","description":"The URL that can be used to automatically complete the field.","readOnly":true},"hasDefaultValue":{"type":"boolean","description":"Indicates whether the field has a default value.","readOnly":true},"operations":{"type":"array","description":"The list of operations that can be performed on the field.","readOnly":true,"items":{"type":"string","readOnly":true}},"allowedValues":{"type":"array","description":"The list of values allowed in the field.","readOnly":true,"items":{"readOnly":true}},"defaultValue":{"description":"The default value of the field.","readOnly":true}},"additionalProperties":false,"description":"The metadata describing an issue field.","xml":{"name":"availableField"}},"CommentCreateDTO":{"type":"object","properties":{"body":{"type":"string","description":"Content of the comment."},"public":{"type":"boolean","description":"Indicates whether the comment is public (true) or private/internal (false)."}},"additionalProperties":false},"PageOfChangelogs":{"type":"object","properties":{"startAt":{"type":"integer","description":"The index of the first item returned on the page.","format":"int32","readOnly":true},"maxResults":{"type":"integer","description":"The maximum number of results that could be on the page.","format":"int32","readOnly":true},"total":{"type":"integer","description":"The number of results on the page.","format":"int32","readOnly":true},"histories":{"type":"array","description":"The list of changelogs.","readOnly":true,"items":{"$ref":"#/components/schemas/Changelog"}}},"additionalProperties":false,"description":"A page of changelogs."},"SelfLinkDTO":{"type":"object","properties":{"self":{"type":"string","format":"uri"}},"additionalProperties":false},"HistoryMetadata":{"type":"object","properties":{"type":{"type":"string","description":"The type of the history record."},"description":{"type":"string","description":"The description of the history record."},"descriptionKey":{"type":"string","description":"The description key of the history record."},"activityDescription":{"type":"string","description":"The activity described in the history record."},"activityDescriptionKey":{"type":"string","description":"The key of the activity described in the history record."},"emailDescription":{"type":"string","description":"The description of the email address associated the history record."},"emailDescriptionKey":{"type":"string","description":"The description key of the email address associated the history record."},"actor":{"description":"Details of the user whose action created the history record.","allOf":[{"$ref":"#/components/schemas/HistoryMetadataParticipant"}]},"generator":{"description":"Details of the system that generated the history record.","allOf":[{"$ref":"#/components/schemas/HistoryMetadataParticipant"}]},"cause":{"description":"Details of the cause that triggered the creation the history record.","allOf":[{"$ref":"#/components/schemas/HistoryMetadataParticipant"}]},"extraData":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional arbitrary information about the history record."}},"additionalProperties":true,"description":"Details of issue history metadata."},"UsersOrganizationUpdateDTO":{"type":"object","properties":{"usernames":{"type":"array","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. Use `accountIds` instead.","items":{"type":"string"}},"accountIds":{"type":"array","description":"List of customers, specific by account IDs, to add to or remove from the organization.","items":{"type":"string"}}},"additionalProperties":false},"CustomerRequestFieldValueDTO":{"type":"object","properties":{"fieldId":{"type":"string","description":"ID of the field."},"label":{"type":"string","description":"Text label for the field."},"value":{"description":"Value of the field."},"renderedValue":{"type":"object","description":"Value of the field rendered in the UI."}},"additionalProperties":false},"UserDTO":{"type":"object","properties":{"accountId":{"type":"string","description":"The accountId of the user, which uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*."},"name":{"type":"string","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details."},"key":{"type":"string","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details."},"emailAddress":{"type":"string","description":"Customer's email address. Depending on the customer’s privacy settings, this may be returned as null."},"displayName":{"type":"string","description":"Customer's name for display in a UI. Depending on the customer’s privacy settings, this may return an alternative value."},"active":{"type":"boolean","description":"Indicates if the customer is active (true) or inactive (false)"},"timeZone":{"type":"string","description":"Customer time zone. Depending on the customer’s privacy settings, this may be returned as null."},"_links":{"description":"URLs for the customer record and related items.","allOf":[{"$ref":"#/components/schemas/UserLinkDTO"}]}},"additionalProperties":false},"PagedDTOUserDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/UserDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"DateDTO":{"type":"object","properties":{"iso8601":{"type":"string","description":"Date in ISO8601 format."},"jira":{"type":"string","description":"Date in the format used in the Jira REST APIs, which is ISO8601 format but extended with milliseconds. For example, 2016-09-28T23:08:32.097+1000."},"friendly":{"type":"string","description":"Date in a user-friendly text format."},"epochMillis":{"type":"integer","description":"Date as the number of milliseconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), 1 January 1970.","format":"int64"}},"additionalProperties":false},"SlaInformationDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the Service Level Agreement (SLA)."},"name":{"type":"string","description":"Description of the SLA."},"completedCycles":{"type":"array","description":"List of completed cycles for the SLA.","items":{"$ref":"#/components/schemas/SlaInformationCompletedCycleDTO"}},"ongoingCycle":{"description":"Details of the active cycle for the SLA.","allOf":[{"$ref":"#/components/schemas/SlaInformationOngoingCycleDTO"}]},"_links":{"description":"REST API URL for the SLA.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"ArticleDTO":{"type":"object","properties":{"title":{"type":"string","description":"Title of the article."},"excerpt":{"type":"string","description":"Excerpt of the article which matches the given query string."},"source":{"description":"Source of the article.","allOf":[{"$ref":"#/components/schemas/SourceDTO"}]},"content":{"$ref":"#/components/schemas/ContentDTO"}},"additionalProperties":false},"SourceDTO":{"type":"object","properties":{"type":{"type":"string","description":"Type of the knowledge base source","enum":["confluence"]}},"additionalProperties":true},"UserDetails":{"type":"object","properties":{"self":{"type":"string","description":"The URL of the user.","readOnly":true},"name":{"type":"string","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.","readOnly":true},"key":{"type":"string","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.","readOnly":true},"accountId":{"type":"string","description":"The accountId of the user, which uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*."},"emailAddress":{"type":"string","description":"The email address of the user. Depending on the user’s privacy settings, this may be returned as null.","readOnly":true},"avatarUrls":{"description":"The avatars of the user.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/AvatarUrlsBean"}]},"displayName":{"type":"string","description":"The display name of the user. Depending on the user’s privacy settings, this may return an alternative value.","readOnly":true},"active":{"type":"boolean","description":"Whether the user is active.","readOnly":true},"timeZone":{"type":"string","description":"The time zone specified in the user's profile. Depending on the user’s privacy settings, this may be returned as null.","readOnly":true},"accountType":{"type":"string","description":"The type of account represented by this user. This will be one of 'atlassian' (normal users), 'app' (application user) or 'customer' (Jira Service Desk customer user)","readOnly":true}},"additionalProperties":false,"description":"User details."},"SimpleLink":{"type":"object","properties":{"id":{"type":"string"},"styleClass":{"type":"string"},"iconClass":{"type":"string"},"label":{"type":"string"},"title":{"type":"string"},"href":{"type":"string"},"weight":{"type":"integer","format":"int32"}},"additionalProperties":false,"description":"Details about the operations available in this version.","xml":{"name":"link"}},"RenderedValueDTO":{"type":"object","properties":{"html":{"type":"string"}},"additionalProperties":false},"SlaInformationCompletedCycleDTO":{"type":"object","properties":{"startTime":{"description":"Time and date at which the SLA cycle started.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"stopTime":{"description":"Time and date at which the SLA cycle completed.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"breached":{"type":"boolean","description":"Indicates if the SLA (duration) was exceeded (true) or not (false)."},"goalDuration":{"description":"Duration within which the service should have been completed.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]},"elapsedTime":{"description":"Duration in which the service was completed.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]},"remainingTime":{"description":"Duration remaining after the service was completed.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]}},"additionalProperties":false},"PagedDTOArticleDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/ArticleDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"PagedDTOIssueBean":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/IssueBean"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"RequestTypeDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID for the request type."},"name":{"type":"string","description":"Short name for the request type."},"description":{"type":"string","description":"Description of the request type."},"helpText":{"type":"string","description":"Help text for the request type."},"issueTypeId":{"type":"string","description":"ID of the issue type the request type is based upon."},"serviceDeskId":{"type":"string","description":"ID of the service desk the request type belongs to."},"groupIds":{"type":"array","description":"List of the request type groups the request type belongs to.","items":{"type":"string"}},"icon":{"description":"Links to the request type's icons.","allOf":[{"$ref":"#/components/schemas/RequestTypeIconDTO"}]},"fields":{"description":"Fields and additional metadata for creating a request that uses the request type","allOf":[{"$ref":"#/components/schemas/CustomerRequestCreateMetaDTO"}]},"_expands":{"type":"array","description":"List of items that can be expanded in the response by specifying the expand query parameter.","items":{"type":"string"}},"_links":{"description":"REST API URL for the request type.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"Operations":{"type":"object","properties":{"linkGroups":{"type":"array","description":"Details of the link groups defining issue operations.","readOnly":true,"items":{"$ref":"#/components/schemas/LinkGroup"}}},"additionalProperties":true,"description":"Details of the operations that can be performed on the issue."},"CustomerTransitionDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the transition."},"name":{"type":"string","description":"Name of the transition."}},"additionalProperties":false},"HistoryMetadataParticipant":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the user or system associated with a history record."},"displayName":{"type":"string","description":"The display name of the user or system associated with a history record."},"displayNameKey":{"type":"string","description":"The key of the display name of the user or system associated with a history record."},"type":{"type":"string","description":"The type of the user or system associated with a history record."},"avatarUrl":{"type":"string","description":"The URL to an avatar for the user or system associated with a history record."},"url":{"type":"string","description":"The URL of the user or system associated with a history record."}},"additionalProperties":true,"description":"Details of user or system associated with a issue history metadata item."},"PagedDTOCustomerRequestStatusDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/CustomerRequestStatusDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"OrganizationCreateDTO":{"type":"object","properties":{"name":{"type":"string","description":"Name of the organization."}},"additionalProperties":false},"ServiceDeskDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the service desk."},"projectId":{"type":"string","description":"ID of the peer project for the service desk."},"projectName":{"type":"string","description":"Name of the project and service desk."},"projectKey":{"type":"string","description":"Key of the peer project of the service desk."},"_links":{"description":"REST API URL to the service desk.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"RequestParticipantUpdateDTO":{"type":"object","properties":{"usernames":{"type":"array","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. Use `accountIds` instead.","items":{"type":"string"}},"accountIds":{"type":"array","description":"List of users, specified by account IDs, to add to or remove as participants in the request.","items":{"type":"string"}}},"additionalProperties":false},"SoftwareInfoDTO":{"type":"object","properties":{"version":{"type":"string","description":"Jira Service Desk version."},"platformVersion":{"type":"string","description":"Jira Platform version upon which Service Desk is based."},"buildDate":{"description":"Date of the current build.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"buildChangeSet":{"type":"string","description":"Reference of the change set included in the build."},"isLicensedForUse":{"type":"boolean","description":"Indicates whether the instance is licensed (true) or not (false)."},"_links":{"description":"REST API URL of the instance.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"ApprovalDecisionRequestDTO":{"type":"object","properties":{"decision":{"type":"string","description":"Response to the approval request.","enum":["approve","decline"]}},"additionalProperties":false},"RequestTypeGroupDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the request type group"},"name":{"type":"string","description":"Name of the request type group."}},"additionalProperties":false},"OrganizationDTO":{"type":"object","properties":{"id":{"type":"string","description":"A unique system generated ID for the organization."},"name":{"type":"string","description":"Name of the organization."},"_links":{"description":"REST API URL to the organization.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"RequestTypeIconDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the request type icon."},"_links":{"description":"Map of the URLs for the request type icons.","allOf":[{"$ref":"#/components/schemas/RequestTypeIconLinkDTO"}]}},"additionalProperties":false},"AvatarUrlsBean":{"type":"object","properties":{"16x16":{"type":"string","description":"The URL of the item's 16x16 pixel avatar.","format":"uri"},"24x24":{"type":"string","description":"The URL of the item's 24x24 pixel avatar.","format":"uri"},"32x32":{"type":"string","description":"The URL of the item's 32x32 pixel avatar.","format":"uri"},"48x48":{"type":"string","description":"The URL of the item's 48x48 pixel avatar.","format":"uri"}},"additionalProperties":false},"PagedDTOSlaInformationDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/SlaInformationDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"RequestNotificationSubscriptionDTO":{"type":"object","properties":{"subscribed":{"type":"boolean","description":"Indicates whether the user is subscribed (true) or not (false) to the request's notifications."}},"additionalProperties":false},"PropertyKeys":{"type":"object","properties":{"keys":{"type":"array","description":"Property key details.","readOnly":true,"items":{"$ref":"#/components/schemas/PropertyKey"}}},"additionalProperties":false,"description":"List of property keys."},"RequestTypeCreateDTO":{"type":"object","properties":{"issueTypeId":{"type":"string","description":"ID of the request type to add to the service desk."},"name":{"type":"string","description":"Name of the request type on the service desk."},"description":{"type":"string","description":"Description of the request type on the service desk."},"helpText":{"type":"string","description":"Help text for the request type on the service desk."}},"additionalProperties":false},"AdditionalCommentDTO":{"type":"object","properties":{"body":{"type":"string","description":"Content of the comment."}},"additionalProperties":false},"RequestTypeFieldDTO":{"type":"object","properties":{"fieldId":{"type":"string","description":"ID of the field."},"name":{"type":"string","description":"Name of the field."},"description":{"type":"string","description":"Description of the field."},"required":{"type":"boolean","description":"Indicates if the field is required (true) or not (false)."},"defaultValues":{"type":"array","description":"List of default values for the field.","items":{"$ref":"#/components/schemas/RequestTypeFieldValueDTO"}},"validValues":{"type":"array","description":"List of valid values for the field.","items":{"$ref":"#/components/schemas/RequestTypeFieldValueDTO"}},"jiraSchema":{"description":"Jira specific implementation details for the field in the UI.","allOf":[{"$ref":"#/components/schemas/JsonTypeBean"}]}},"additionalProperties":false},"StatusDetails":{"type":"object","properties":{"self":{"type":"string","description":"The URL of the status.","readOnly":true},"description":{"type":"string","description":"The description of the status.","readOnly":true},"iconUrl":{"type":"string","description":"The URL of the icon used to represent the status.","readOnly":true},"name":{"type":"string","description":"The name of the status.","readOnly":true},"id":{"type":"string","description":"The ID of the status.","readOnly":true},"statusCategory":{"description":"The category assigned to the status.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/StatusCategory"}]}},"additionalProperties":true,"description":"A status."},"PagedDTOAttachmentDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/AttachmentDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"PagedLinkDTO":{"type":"object","properties":{"self":{"type":"string","description":"REST API URL for the current page.","format":"uri"},"base":{"type":"string","description":"Base URL for the REST API calls.","format":"uri"},"context":{"type":"string"},"next":{"type":"string","description":"REST API URL for the next page, if there is one.","format":"uri"},"prev":{"type":"string","description":"REST API URL for the previous page, if there is one.","format":"uri"}},"additionalProperties":false},"RequestTypeIconLinkDTO":{"type":"object","properties":{"iconUrls":{"type":"object","additionalProperties":{"type":"string","format":"uri"},"description":"URLs for the request type icons."}},"additionalProperties":false},"CustomerRequestDTO":{"type":"object","properties":{"issueId":{"type":"string","description":"ID of the request, as the peer issue ID."},"issueKey":{"type":"string","description":"Key of the request, as the peer issue key."},"requestTypeId":{"type":"string","description":"ID of the request type for the request."},"requestType":{"description":"Expandable details of the request type.","allOf":[{"$ref":"#/components/schemas/RequestTypeDTO"}]},"serviceDeskId":{"type":"string","description":"ID of the service desk the request belongs to."},"serviceDesk":{"description":"Expandable details of the service desk.","allOf":[{"$ref":"#/components/schemas/ServiceDeskDTO"}]},"createdDate":{"description":"Date on which the request was created.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"reporter":{"description":"Details of the customer reporting the request.","allOf":[{"$ref":"#/components/schemas/UserDTO"}]},"requestFieldValues":{"type":"array","description":"JSON map of Jira field IDs and their values representing the content of the request.","items":{"$ref":"#/components/schemas/CustomerRequestFieldValueDTO"}},"currentStatus":{"description":"Status of the request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestStatusDTO"}]},"status":{"description":"Expandable details of the request's status history.","allOf":[{"$ref":"#/components/schemas/PagedDTOCustomerRequestStatusDTO"}]},"participants":{"description":"Expandable details of the customers participating in the request.","allOf":[{"$ref":"#/components/schemas/PagedDTOUserDTO"}]},"sla":{"description":"Expandable details of the SLAs relating to the request.","allOf":[{"$ref":"#/components/schemas/PagedDTOSlaInformationDTO"}]},"attachments":{"description":"List of attachments included with the request.","allOf":[{"$ref":"#/components/schemas/PagedDTOAttachmentDTO"}]},"comments":{"description":"List of comments included with the request.","allOf":[{"$ref":"#/components/schemas/PagedDTOCommentDTO"}]},"actions":{"description":"List of actions that the user can take on the request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestActionsDTO"}]},"_expands":{"type":"array","description":"List of items that can be expanded in the response by specifying the expand query parameter.","items":{"type":"string"}},"_links":{"description":"List of links associated with the request.","allOf":[{"$ref":"#/components/schemas/CustomerRequestLinkDTO"}]}},"additionalProperties":false},"CustomerRequestLinkDTO":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"jiraRest":{"type":"string","description":"REST API URL for the request.","format":"uri"},"web":{"type":"string","description":"Web URL for the request.","format":"uri"}},"additionalProperties":false},"CSATFeedbackFullDTO":{"type":"object","properties":{"type":{"type":"string","description":"Indicates the type of feedback, supported values: `csat`."},"rating":{"type":"integer","description":"A numeric representation of the rating, this must be an integer value between 1 and 5.","format":"int32"},"comment":{"description":"(Optional) The comment provided with this feedback.","allOf":[{"$ref":"#/components/schemas/AdditionalCommentDTO"}]}},"additionalProperties":false},"CustomerRequestStatusDTO":{"type":"object","properties":{"status":{"type":"string","description":"Name of the status condition."},"statusCategory":{"type":"string","description":"Status category the status belongs to.","enum":["UNDEFINED","NEW","INDETERMINATE","DONE"]},"statusDate":{"description":"Date on which the status was attained.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]}},"additionalProperties":false},"PagedDTOCommentDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/CommentDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"CustomerCreateDTO":{"type":"object","properties":{"email":{"type":"string","description":"Customer's email address."},"fullName":{"type":"string","description":"Deprecated, please use 'displayName'."},"displayName":{"type":"string","description":"Customer's name for display in the UI."}},"additionalProperties":false},"CommentDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the comment."},"body":{"type":"string","description":"Content of the comment."},"renderedBody":{"description":"The rendered body of the comment.","allOf":[{"$ref":"#/components/schemas/RenderedValueDTO"}]},"author":{"description":"Details of the customer who authored the comment.","allOf":[{"$ref":"#/components/schemas/UserDTO"}]},"created":{"description":"Date the comment was created.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"attachments":{"description":"List of the attachments included in the comment.","allOf":[{"$ref":"#/components/schemas/PagedDTOAttachmentDTO"}]},"_expands":{"type":"array","description":"List of items that can be expanded in the response by specifying the expand query parameter.","items":{"type":"string"}},"public":{"type":"boolean","description":"Indicates whether the comment is public (true) or private/internal (false)."},"_links":{"description":"REST API URL link to the comment.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"PagedDTOApprovalDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/ApprovalDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"PagedDTOQueueDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/QueueDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"IssueUpdateMetadata":{"type":"object","properties":{"fields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/FieldMetadata"},"description":"A list of editable field details.","readOnly":true}},"description":"A list of editable field details."},"LinkGroup":{"type":"object","properties":{"id":{"type":"string"},"styleClass":{"type":"string"},"header":{"$ref":"#/components/schemas/SimpleLink"},"weight":{"type":"integer","format":"int32"},"links":{"type":"array","items":{"$ref":"#/components/schemas/SimpleLink"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/LinkGroup"}}},"additionalProperties":false,"description":"Details a link group, which defines issue operations."},"OrganizationServiceDeskUpdateDTO":{"type":"object","properties":{"organizationId":{"type":"integer","description":"List of organizations, specified by 'ID' field values, to add to or remove from the service desk.","format":"int32"}},"additionalProperties":false},"ChangeDetails":{"type":"object","properties":{"field":{"type":"string","description":"The name of the field changed.","readOnly":true},"fieldtype":{"type":"string","description":"The type of the field changed.","readOnly":true},"fieldId":{"type":"string","description":"The ID of the field changed.","readOnly":true},"from":{"type":"string","description":"The details of the original value.","readOnly":true},"fromString":{"type":"string","description":"The details of the original value as a string.","readOnly":true},"to":{"type":"string","description":"The details of the new value.","readOnly":true},"toString":{"type":"string","description":"The details of the new value as a string.","readOnly":true}},"additionalProperties":false,"description":"A change item."},"ContentDTO":{"type":"object","properties":{"iframeSrc":{"type":"string","description":"Url containing the body of the article (without title), suitable for rendering in an iframe"}},"additionalProperties":false},"EntityProperty":{"type":"object","properties":{"key":{"type":"string","description":"The key of the property. Required on create and update."},"value":{"description":"The value of the property. Required on create and update."}},"additionalProperties":false,"description":"An entity property, for more information see [Entity properties](https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/)."},"AttachmentDTO":{"type":"object","properties":{"filename":{"type":"string","description":"Filename of the item attached."},"author":{"description":"Details of the user who attached the file.","allOf":[{"$ref":"#/components/schemas/UserDTO"}]},"created":{"description":"Date the attachment was added.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"size":{"type":"integer","description":"Size of the attachment in bytes.","format":"int64"},"mimeType":{"type":"string","description":"MIME type of the attachment."},"_links":{"description":"Various URLs for the attachment.","allOf":[{"$ref":"#/components/schemas/AttachmentLinkDTO"}]}},"additionalProperties":false},"StatusCategory":{"type":"object","properties":{"self":{"type":"string","description":"The URL of the status category.","readOnly":true},"id":{"type":"integer","description":"The ID of the status category.","format":"int64","readOnly":true},"key":{"type":"string","description":"The key of the status category.","readOnly":true},"colorName":{"type":"string","description":"The name of the color used to represent the status category.","readOnly":true},"name":{"type":"string","description":"The name of the status category.","readOnly":true}},"additionalProperties":true,"description":"A status category."},"RequestCreateDTO":{"type":"object","properties":{"serviceDeskId":{"type":"string","description":"ID of the service desk in which to create the request."},"requestTypeId":{"type":"string","description":"ID of the request type for the request."},"requestFieldValues":{"type":"object","additionalProperties":{},"description":"JSON map of Jira field IDs and their values representing the content of the request."},"requestParticipants":{"type":"array","description":"List of customers to participate in the request, as a list of `accountId` values.","items":{"type":"string"}},"raiseOnBehalfOf":{"type":"string","description":"The `accountId` of the customer that the request is being raised on behalf of."},"channel":{"type":"string","description":"(Experimental) Shows extra information for the request channel."}},"additionalProperties":false},"CustomerRequestCreateMetaDTO":{"type":"object","properties":{"requestTypeFields":{"type":"array","description":"List of the fields included in this request.","items":{"$ref":"#/components/schemas/RequestTypeFieldDTO"}},"canRaiseOnBehalfOf":{"type":"boolean","description":"Flag indicating if a request can be raised on behalf of another user (true) or not."},"canAddRequestParticipants":{"type":"boolean","description":"Flag indicating if participants can be added to a request (true) or not."}},"additionalProperties":false},"AttachmentLinkDTO":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"jiraRest":{"type":"string","description":"REST API URL for the attachment","format":"uri"},"content":{"type":"string","description":"URL for the attachment.","format":"uri"},"thumbnail":{"type":"string","description":"URL for the attachment's thumbnail image.","format":"uri"}},"additionalProperties":false},"I18nErrorMessage":{"type":"object","properties":{"i18nKey":{"type":"string"},"parameters":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"AttachmentCreateDTO":{"type":"object","properties":{"temporaryAttachmentIds":{"type":"array","description":"List of IDs for the temporary attachments to be added to the customer request.","items":{"type":"string"}},"additionalComment":{"description":"Comment about the attachments.","allOf":[{"$ref":"#/components/schemas/AdditionalCommentDTO"}]},"public":{"type":"boolean","description":"Indicates whether the attachments are to be public (true) or private/internal (false)."}},"additionalProperties":false},"CustomerRequestActionDTO":{"type":"object","properties":{"allowed":{"type":"boolean","description":"Indicates whether the user can undertake the action (true) or not (false)."}},"additionalProperties":false},"PagedDTORequestTypeGroupDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/RequestTypeGroupDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"PagedDTOCustomerRequestDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/CustomerRequestDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"Changelog":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the changelog.","readOnly":true},"author":{"description":"The user who made the change.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/UserDetails"}]},"created":{"type":"string","description":"The date on which the change took place.","format":"date-time","readOnly":true},"items":{"type":"array","description":"The list of items changed.","readOnly":true,"items":{"$ref":"#/components/schemas/ChangeDetails"}},"historyMetadata":{"description":"The history metadata associated with the changed.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/HistoryMetadata"}]}},"additionalProperties":false,"description":"A changelog."},"AttachmentCreateResultDTO":{"type":"object","properties":{"comment":{"description":"Details of the comment included with the attachments.","allOf":[{"$ref":"#/components/schemas/CommentDTO"}]},"attachments":{"description":"List of the attachments added.","allOf":[{"$ref":"#/components/schemas/PagedDTOAttachmentDTO"}]}},"additionalProperties":false},"ApprovalDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the approval."},"name":{"type":"string","description":"Description of the approval being sought or provided."},"finalDecision":{"type":"string","description":"Outcome of the approval, based on the approvals provided by all approvers.","enum":["approved","declined","pending"]},"canAnswerApproval":{"type":"boolean","description":"Indicates whether the user making the request is one of the approvers and can respond to the approval (true) or not (false)."},"approvers":{"type":"array","description":"Detailed list of the users who must provide a response to the approval.","items":{"$ref":"#/components/schemas/ApproverDTO"}},"createdDate":{"description":"Date the approval was created.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"completedDate":{"description":"Date the approval was completed.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"_links":{"description":"The REST API URL of the approval.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"QueueDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID for the queue."},"name":{"type":"string","description":"Short name for the queue."},"jql":{"type":"string","description":"JQL query that filters reqeusts for the queue."},"fields":{"type":"array","description":"Fields returned for each request in the queue.","items":{"type":"string"}},"issueCount":{"type":"integer","description":"The count of customer requests in the queue.","format":"int64"},"_links":{"description":"REST API URL to the queue.","allOf":[{"$ref":"#/components/schemas/SelfLinkDTO"}]}},"additionalProperties":false},"DurationDTO":{"type":"object","properties":{"millis":{"type":"integer","description":"Duration in milliseconds.","format":"int64"},"friendly":{"type":"string","description":"Duration in a user-friendly text format."}},"additionalProperties":false},"UserLinkDTO":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"jiraRest":{"type":"string","description":"REST API URL for the customer.","format":"uri"},"avatarUrls":{"type":"object","additionalProperties":{"type":"string"},"description":"Links to the various sizes of the customer's avatar. Note that this property is deprecated, and will be removed in future versions."}},"additionalProperties":false},"ServiceDeskCustomerDTO":{"type":"object","properties":{"usernames":{"uniqueItems":true,"type":"array","description":"This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. Use `accountIds` instead.","items":{"type":"string"}},"accountIds":{"uniqueItems":true,"type":"array","description":"List of users, specified by account IDs, to add to or remove from a service desk.","items":{"type":"string"}}},"additionalProperties":false},"RequestTypeFieldValueDTO":{"type":"object","properties":{"value":{"type":"string","description":"Value of the field."},"label":{"type":"string","description":"Label for the field."},"children":{"type":"array","description":"List of child fields.","items":{"$ref":"#/components/schemas/RequestTypeFieldValueDTO"}}},"additionalProperties":false},"IssueBean":{"type":"object","properties":{"expand":{"type":"string","description":"Expand options that include additional issue details in the response.","readOnly":true,"xml":{"attribute":true}},"id":{"type":"string","description":"The ID of the issue.","readOnly":true},"self":{"type":"string","description":"The URL of the issue details.","format":"uri","readOnly":true},"key":{"type":"string","description":"The key of the issue.","readOnly":true},"renderedFields":{"type":"object","additionalProperties":{"readOnly":true},"description":"The rendered value of each field present on the issue.","readOnly":true},"properties":{"type":"object","additionalProperties":{"readOnly":true},"description":"Details of the issue properties identified in the request.","readOnly":true},"names":{"type":"object","additionalProperties":{"type":"string","readOnly":true},"description":"The ID and name of each field present on the issue.","readOnly":true},"schema":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonTypeBean"},"description":"The schema describing each field present on the issue.","readOnly":true},"transitions":{"type":"array","description":"The transitions that can be performed on the issue.","readOnly":true,"items":{"$ref":"#/components/schemas/IssueTransition"}},"operations":{"description":"The operations that can be performed on the issue.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/Operations"}]},"editmeta":{"description":"The metadata for the fields on the issue that can be amended.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/IssueUpdateMetadata"}]},"changelog":{"description":"Details of changelogs associated with the issue.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/PageOfChangelogs"}]},"versionedRepresentations":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"readOnly":true},"readOnly":true},"description":"The versions of each field on the issue.","readOnly":true},"fieldsToInclude":{"$ref":"#/components/schemas/IncludedFields"},"fields":{"type":"object","additionalProperties":{}}},"additionalProperties":false,"xml":{"name":"issue"}},"CustomerTransitionExecutionDTO":{"type":"object","properties":{"id":{"type":"string","description":"ID of the transition to be performed."},"additionalComment":{"description":"Comment explaining the reason for the transition.","allOf":[{"$ref":"#/components/schemas/AdditionalCommentDTO"}]}},"additionalProperties":false},"ApproverDTO":{"type":"object","properties":{"approver":{"description":"Details of the User who is providing approval.","allOf":[{"$ref":"#/components/schemas/UserDTO"}]},"approverDecision":{"type":"string","description":"Decision made by the approver.","enum":["approved","declined","pending"]}},"additionalProperties":false},"IssueTransition":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the issue transition. Required when specifying a transition to undertake."},"name":{"type":"string","description":"The name of the issue transition.","readOnly":true},"to":{"description":"Details of the issue status after the transition.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/StatusDetails"}]},"hasScreen":{"type":"boolean","description":"Indicates whether there is a screen associated with the issue transition.","readOnly":true},"isGlobal":{"type":"boolean","description":"Indicates whether the issue transition is global, that is, the transition is applied to issues regardless of their status.","readOnly":true},"isInitial":{"type":"boolean","description":"Indicates whether this is the initial issue transition for the workflow.","readOnly":true},"isConditional":{"type":"boolean","description":"Indicates whether the issue has to meet certain criteria before the issue transition is applied.","readOnly":true},"fields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/FieldMetadata"},"description":"Details of the fields associated with the issue transition screen. Use this information to populate `fields` and `update` in a transition request.","readOnly":true},"expand":{"type":"string","description":"Expand options that include additional transition details in the response.","readOnly":true}},"additionalProperties":true,"description":"Details of an issue transition."},"JsonTypeBean":{"required":["type"],"type":"object","properties":{"type":{"type":"string","description":"The data type of the field.","readOnly":true},"items":{"type":"string","description":"When the data type is an array, the name of the field items within the array.","readOnly":true},"system":{"type":"string","description":"If the field is a system field, the name of the field.","readOnly":true},"custom":{"type":"string","description":"If the field is a custom field, the URI of the field.","readOnly":true},"customId":{"type":"integer","description":"If the field is a custom field, the custom ID of the field.","format":"int64","readOnly":true},"configuration":{"type":"object","additionalProperties":{"readOnly":true},"description":"If the field is a custom field, the configuration of the field.","readOnly":true}},"additionalProperties":false,"description":"The schema of a field."},"PagedDTOServiceDeskDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/ServiceDeskDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"SlaInformationOngoingCycleDTO":{"type":"object","properties":{"startTime":{"description":"Time and date at which the SLA cycle started.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"breachTime":{"description":"Time and date at which the SLA cycle would have breached its limit.","allOf":[{"$ref":"#/components/schemas/DateDTO"}]},"breached":{"type":"boolean","description":"Indicates whether the SLA has been breached (true) or not (false)."},"paused":{"type":"boolean","description":"Indicates whether the SLA is paused (true) or not (false)."},"withinCalendarHours":{"type":"boolean","description":"Indicates whether the SLA it timed during calendared working hours only (true) or not (false)."},"goalDuration":{"description":"Duration within which the service should be completed.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]},"elapsedTime":{"description":"Duration of the service.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]},"remainingTime":{"description":"Duration remaining in which to complete the service.","allOf":[{"$ref":"#/components/schemas/DurationDTO"}]}},"additionalProperties":false},"PagedDTORequestTypeDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/RequestTypeDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"PagedDTOCustomerTransitionDTO":{"type":"object","properties":{"size":{"type":"integer","description":"Number of items returned in the page.","format":"int32"},"start":{"type":"integer","description":"Index of the first item returned in the page.","format":"int32"},"limit":{"type":"integer","description":"Number of items to be returned per page, up to the maximum set for these objects in the current implementation.","format":"int32"},"isLastPage":{"type":"boolean","description":"Indicates if this is the last page of records (true) or not (false)."},"values":{"type":"array","description":"Details of the items included in the page.","items":{"$ref":"#/components/schemas/CustomerTransitionDTO"}},"_expands":{"type":"array","items":{"type":"string"}},"_links":{"description":"List of the links relating to the page.","allOf":[{"$ref":"#/components/schemas/PagedLinkDTO"}]}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorMessage":{"type":"string"},"i18nErrorMessage":{"$ref":"#/components/schemas/I18nErrorMessage"}},"additionalProperties":false},"PropertyKey":{"type":"object","properties":{"self":{"type":"string","description":"The URL of the property.","readOnly":true},"key":{"type":"string","description":"The key of the property.","readOnly":true}},"additionalProperties":false,"description":"Property key details."}},"securitySchemes":{"basicAuth":{"type":"http","description":"You can access this resource via basic auth.","scheme":"basic"},"OAuth2":{"type":"oauth2","description":"OAuth2 scopes for Jira","flows":{"authorizationCode":{"authorizationUrl":"https://auth.atlassian.com/authorize","tokenUrl":"https://auth.atlassian.com/oauth/token","scopes":{"read:jira-user":"View user information in Jira that you have access to, including usernames, email addresses, and avatars.","read:jira-work":"Read project and issue data. Search for issues and objects associated with issues (such as attachments and worklogs).","write:jira-work":"Create and edit issues in Jira, post comments, create worklogs, and delete issues.","manage:jira-project":"Create and edit project settings and create new project-level objects, for example, versions, components.","manage:jira-configuration":"Configure Jira settings that require the Jira administrators permission, for example, create projects and custom fields, view workflows, manage issue link types.","read:servicedesk-request":"Read customer request data, including approvals, attachments, comments, request participants, and status/transitions.<br>Read service desk and request types, including searching for request types and reading request type fields, properties and groups.","write:servicedesk-request":"Create and manage Jira Service Desk requests | Create and edit customer requests, including add comments and attachments, approve, share (add request participants), subscribe, and transition.","manage:servicedesk-customer":"Manage Jira Service Desk customers and organizations | Create, manage and delete customers and organizations.<br>Add and remove customers and organizations from service desks."}}}}}},"x-atlassian-narrative":{"documents":[{"title":"About","anchor":"about","body":"This is the reference for the Jira Service Desk Cloud REST APIs. The REST APIs are for developers who want to integrate\n Jira Service Desk with other applications or administrators that want to automate their workflows and processes.\n \n **NOTE:** Personal data that is used to identify users, such as `username` and `userKey`, has been \n removed from the Jira Cloud REST APIs. In addition, other personal data (for example, email) is now restricted by a \n user's profile settings (or in the case of managed accounts, the visibility settings decided by the site administrator). \n You must update your apps to accommodate these changes, if you have not done so already. This change was previously \n announced on 01 October 2018 and followed by a deprecation period \n (see the [announcement](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/))."},{"title":"Jira Cloud Platform APIs","anchor":"jira-cloud-platform-apis","body":"Jira Service Desk is built upon the Jira platform. As such, in Jira Service Desk you have access to the Jira \nplatform REST APIs. \n\nIf you are writing an Atlassian Connect app, your app can request access to the Jira platform \nREST APIs by using the correct Jira platform Connect Scopes.\n\n * [Browse the Jira platform REST APIs](/cloud/jira/platform/rest/)\n * [Browse the Jira platform Connect Scopes](/cloud/jira/platform/scopes/)\n"},{"title":"Permissions and roles","anchor":"permissions","body":"Permissions control the level of a user's access to the Jira Service Desk instance, while roles are how the permissions are assigned to individual users. \n\nFor detailed information on roles and permissions, see [Permissions overview](https://confluence.atlassian.com/display/SERVICEDESKCLOUD/Permissions+overview) and [Setting up service desk users](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html).\n\n**Permission types**\n\n- Global -  These apply to applications as a whole, not individual projects. \n- Project - Organized into permission schemes, these apply to projects.\n- Issue - Organized into security schemes, these allow the visibility of individual issues to be adjusted.\n\n**Roles**\n\n - Jira System Administrator - can perform all Jira administration functions.\n - Jira Administrator - can perform most Jira administration functions.\n - Service desk Administrator (Project role - Administrator) - assigned to specific Service Desks and manages those service desk’s configurations.\n - Agent (Project role - service desk Team member) - assigned to specific Service Desks and manages and responds to Requests.\n - Customer - can submit and update their Requests, and may participate in Requests raised by other Customers."},{"title":"Service desk types","anchor":"desks","body":"It is also worth noting that the ability of Customers to raise Requests depends on the service desk type, which can be:\n\n -   Public (sign up): Anyone who has the service desk URL can submit requests, and a user (customer) is created for them when a request is submitted.\n -   Open: Any user in the system can submit requests, they don’t need to be associated with the service desk.\n -   Closed: Only users associated with the service desk can submit requests.\n\nFor more details, see [Managing access to your service desk](https://confluence.atlassian.com/display/SERVICEDESKCLOUD/Managing+access+to+your+service+desk?_ga=1.89730907.1347621636.1491429859) in the Jira Service Desk Cloud documentation.\n\n"},{"title":"Authentication","anchor":"authentication","body":"The Jira Service Desk REST API uses the same authentication methods as Jira Cloud.\n\n### Authentication for Atlassian Connect apps\n\nIf you are building an Atlassian Connect app to interact with the Jira Service Desk Cloud REST API, \nauthentication is handled by [JWT (JSON Web Token)](http://tools.ietf.org/html/draft-ietf-oauth-json-web-token) \ntechnology. This is built into the supported Atlassian Connect libraries. \nAt a high level, a security context is exchanged when the app is installed, \nand this context is used to create and validate JWT tokens, embedded in API calls. \nTo learn more, \nread the [Authentication for apps](https://developer.atlassian.com/cloud/jira/service-desk/authentication-for-apps/) guide.\n\n### Authentication for REST API requests\n\nIf you are integrating directly with the Jira Service Desk Cloud REST APIs it is recommended to use \n[OAuth authentication](https://developer.atlassian.com/cloud/jira/service-desk/jira-rest-api-oauth-authentication/) method. \nFor implementations with low security requirements, such as scripts and bots, it is also possible to use \n[Basic authentication](https://developer.atlassian.com/cloud/jira/service-desk/jira-rest-api-basic-authentication/) method.\n\nJira Service Desk itself uses \n[cookie-based authentication](https://developer.atlassian.com/cloud/jira/service-desk/jira-rest-api-cookie-based-authentication/) \nin the browser, so you can call the REST API from JavaScript on the page and rely on the authentication that the browser has established.\n\n### Authentication for other integrations\n\nIf you are building an integration that does not use Atlassian Connect, use OAuth 2.0 authorization code grants \n(also known as three-legged OAuth) for authentication. Note, the base URL for requests made via OAuth 2.0 authorization \ncode grants is `https://api.atlassian.com`. If you are copying the examples in this document, you'll need to change the URLs \nfrom `https://your-domain.atlassian.net/{api}` to `https://api.atlassian.com/ex/jira/{cloudid}/{api}`. To learn more, \nread [OAuth 2.0 authorization code grants (3LO)](https://developer.atlassian.com/cloud/jira/service-desk/oauth-2-authorization-code-grants-3lo-for-apps/).  \n"},{"title":"Scopes","anchor":"scopes","body":"Scopes provide static authorization for Atlassian Connect apps. If you are using your own credentials to make REST calls, then these scopes do not apply.\n\nScopes are defined in the [Connect app descriptor](https://developer.atlassian.com/cloud/jira/service-desk/app-descriptor/) and specify the maximum set of actions that an app may perform: read, write, etc. This security level is enforced by Atlassian Connect and cannot be bypassed by app implementations.\n\nFor the list of Jira Service Desk REST scopes, see [Scopes](https://developer.atlassian.com/cloud/jira/service-desk/scopes/).\n"},{"title":"Status codes and responses","anchor":"status","body":"\n -   <span class=\"aui-lozenge aui-lozenge-success\">Status 200</span> Returned if the requested content (GET) is returned or content is updated (PUT).\n -   <span class=\"aui-lozenge aui-lozenge-success\">Status 201</span> Returned if new records are created (PUT).\n -   <span class=\"aui-lozenge aui-lozenge-success\">Status 204</span> Returned where the request may or may not have been actioned, but the outcome is as expected. For example, the request was to remove a customer from an organization, but the customer was not associated with the organization.\n -   <span class=\"aui-lozenge aui-lozenge-error\">Status 400</span> Returned if the request was invalid.\n -   <span class=\"aui-lozenge aui-lozenge-error\">Status 401</span> Returned if the user is not logged in. Resolve by logging the user in and reissuing the call.\n -   <span class=\"aui-lozenge aui-lozenge-error\">Status 403</span> Returned if the user does not have the necessary permission to access the resource or run the method.\n -   <span class=\"aui-lozenge aui-lozenge-error\">Status 404</span> Returned if the passed path parameters do not correspond to an object in the instance, for example, no Organization exists for a passed ID.\n -   <span class=\"aui-lozenge aui-lozenge-error\">Status 412</span> Returned if the API is experimental but the `X-ExperimentalApi: opt-in` header was not passed. For more details, see [Experimental methods](#experimental).\n\nResources will return a response body in addition to the error status codes. The returned entity for errors is as follows:\n\n```json\n{\n  \"errorMessage\": \"Here is an error message\",\n  \"i18nErrorMessage\": {\n    \"i18nKey\": \"some.error.key\",\n    \"parameters\": []\n  }\n}\n```\n"},{"title":"Experimental methods","anchor":"experimental","body":"Methods marked as <span class=\"aui-lozenge aui-lozenge-subtle aui-lozenge-current\">experimental</span> may change without notice. To use experimental methods, you must include the `X-ExperimentalApi: opt-in` header in your requests. Use of this header indicates that you are opting into the experimental preview. Once a resource or method moves out of the experimental phase, then the header will no longer be required or checked.\n\nFeedback on the experimental APIs is welcome and can be provided by submitting a feature request or suggestion through the [Atlassian Ecosystem Help Center](https://ecosystem.atlassian.net/servicedesk/customer/portals) or the [Jira Service Desk Ecosystem](https://ecosystem.atlassian.net/browse/JSDECO).\n"},{"title":"Pagination","anchor":"pagination","body":"The Jira Service Desk REST API uses pagination to conserve server resources and limit the size of responses. Pagination is enforced for methods that could return a large collection. When you make a request to a paged API, the response will wrap the returned values in a JSON object with paging metadata, as follows:\n\n**Request**\n\n```\nhttp://host:port/context/rest/api-name/resource-name?start=0&limit=10\n```\n\n**Response**\n\n```json\n{\n    \"start\" : 0,\n    \"limit\" : 10,\n    \"size\" : 7,\n    \"isLastPage\" : true,\n    \"values\": [\n        { /* result 0 */ },\n        { /* result 1 */ },\n        { /* result 2 */ }\n        { /* result 3 */ }\n        { /* result 4 */ }\n        { /* result 5 */ }\n        { /* result 6 */ }\n    ]\n}\n```\n\nWhere:\n\n - `start` is the index of the first item returned in the page of results.\n - `limit` is the total number of items that could be returned per page, subject to the maximum server enforced limit for the resource’s method. If `limit` isn’t specified the default value of the resource is used.\n - `size` is the number of items returned on this page.\n - `isLastPage` indicates whether the page is the last page of results.\n\nClients can use the `start`, `limit`, and `size` parameters to retrieve the desired number of results. Each resource or method has a unique limit on the maximum number of items returned, which cannot be exceeded. If you request `size` which is larger than the limit, the number of items returned will be capped at the limit for that resource’s method. This behavior can be identified when the first page shows `size` is less than `limit` and `isLastPage` is `false`.\n\nThe limits set for each resource’s method is an implementation detail and may be changed.\n"},{"title":"Expansion","anchor":"expansion","body":"To simplify API responses, the Jira Service Desk REST API uses resource expansion: the API will only return parts of the resource when explicitly requested.\n\nUse the `expand` query parameter to specify the list of entities that you want to be expanded, identifying each of them by name. For example, appending `?expand=serviceDesk&expand=requestType` to a request’s URI results in the inclusion of the service desk and request type details in the response. The following URL would be used to get that information for the request with the ID JSD-1:\n\n```\nhttp://host:port/context/rest/servicedeskapi/request/JSD-1?expand=serviceDesk&expand=requestType\n```\n\nAlternatively, you can pass the list of entities you want to be expanded as a single comma-separated parameter, as in:\n\n```\nhttp://host:port/context/rest/servicedeskapi/request/JSD-1?expand=serviceDesk,requestType\n```\n\nTo discover the expansion identifiers for each entity, look at the `_expands` property in the parent object. In the JSON example below, the resource declares `participant`, `status`, `sla`, `requestType`, and `serviceDesk` as expandable.\n\n```json\n{\n    \"_expands\": [\n        \"participant\",\n        \"status\",\n        \"sla\",\n        \"requestType\",\n        \"serviceDesk\"\n    ],\n    \"issueId\": \"107001\",\n    \"issueKey\": \"HELPDESK-1\",\n    \"requestTypeId\": \"11001\",\n    \"serviceDeskId\": \"10001\",\n    ...\n```\n\n"},{"title":"Request language","anchor":"request-language","body":"By default, responses are translated based on the requesting user's language preference, or the Jira site default \nlanguage if anonymous.\n\nUse the `requestLanguage` query parameter to have responses translated in a specific language, providing an \n[IETF BCP 47](https://tools.ietf.org/html/bcp47) language tag in the form `(language code)-(country code)` as the value. \nE.g. `?requestLanguage=en-US` for English (United States). Both static text (e.g. error messages) and dynamic \nuser-entered text (e.g. workflow status names) will be translated, if available.\n\nThe languages available are based on the installed languages in Jira. If the language tag specified does not match one \nof Jira's languages, then the query parameter will have no effect.\n\nDynamic user-entered translations can be edited in Jira administration for global objects (e.g. priority names) and \nin **Language support** under project administration for Service Desk projects (e.g. request type names)."},{"title":"Special headers","anchor":"special-headers","body":"The following request and response headers define important metadata for the Service Desk REST API resources.\n\n -   **X-Atlassian-Token** (request): Operations that accept multipart/form-data must include the `X-Atlassian-Token: no-check` header in requests. \nOtherwise the request will be blocked by XSRF protection.\n -   **X-ExperimentalApi** (request): Experimental operations must include the `X-ExperimentalApi: opt-in` header in requests. \n Otherwise the request will not be processed. See [Experimental methods](#experimental) for more details.\n-   **X-AACCOUNTID** (response): This response header contains the Atlassian account ID of the authenticated user.\n"},{"title":"Using project identifiers","anchor":"project-identifiers","body":"For convenience, any of the resources that require a `{serviceDeskId}` path parameter also accepts other identifiers.\n\nFor example, if a `ServiceDesk(id: 15)` corresponds to a `Project(id: 10012, key: ABC)`, then issuing a request to any of:\n\n    /rest/servicedeskapi/servicedesk/ABC\n\n    /rest/servicedeskapi/servicedesk/projectKey:ABC\n\n    /rest/servicedeskapi/servicedesk/projectId:10012\n\n    /rest/servicedeskapi/servicedesk/serviceDeskId:15\n\nis equivalent to issuing a request to:\n\n    /rest/servicedeskapi/servicedesk/15\n"},{"title":"Field input formats","anchor":"fieldformats","body":"**Summary** - _A single line of text._\n\n```json\n\n\"summary\": \"An explanation is one line of text.\"\n\n```\n\n**Description** - _Multiple lines of text._\n\n```json\n\n\"description\": \"A description is multiples lines of text\\n separated by\\n line feeds.\",\n\n```\n\n**Components** - _Multiple values addressed by 'name'._\n\n```json\n\n\"components\" : [ { \"name\": \"Active Directory\"} , { \"name\": \"Network Switch\" } ]\n\n```\n\n**Due date** - _A date in 'YYYY-MM-DD' format._\n\n```json\n\n\"duedate\" : \"2015-11-18\"\n\n```\n\n**Labels** - _An array of string values._\n\n```json\n\n\"labels\" : [\"examplelabelnumber1\", \"examplelabelnumber2\"]\n\n```\n\n**Checkbox custom field** - _A custom UI field that enables multiple values to be selected from a defined list of values, with values addressed by 'value' or `id`._\n\n```json\n\n\"customfield_11440\" : [{ \"value\" : \"option1\"}, {\"value\" : \"option2\"}]\n\nor\n\n\"customfield_11440\" : [{ \"id\" : 10112}, {\"id\" : 10115}]\n\n```\n\n**Date picker custom field** - _A custom UI field that enables a date in 'YYYY-MM-DD' format to be picked._\n\n```json\n\n\"customfield_11441\" : \"2015-11-18\"\n\n```\n\n**Date time picker custom field** - _A custom UI field enables a datetime in ISO 8601 ('YYYY-MM-DDThh:mm:ss.sTZD') format to be picked._\n\n```json\n\n\"customfield_11442\" : \"2015-11-18T14:39:00.000+1100\"\n\n```\n\n**Labels custom field** - _A custom UI field that is an array of strings._\n\n```json\n\n\"customfield_11443\" : [ \"rest_label1\", \"rest_label2\" ]\n\n```\n\n**Number custom field** - _A custom UI field that enables a number to be entered._\n\n```json\n\n\"customfield_11444\" : 666\n\n```\n\n**Radio button custom field** - _A custom UI field that enables a single value to be selected from a defined list of values, with values addressed by `value` or `id`._\n\n```json\n\n\"customfield_11445\" : { \"value\": \"option2\" }\n\nor\n\n\"customfield_11445\" : { \"id\": 10112 }\n\n```\n\n**Cascading select custom field** - _A custom UI field that enables a single parent value and then a related child value to be selected, with values addressed by `value` or `id`._\n\n```json\n\n\"customfield_11447\" : { \"value\": \"parent_option1\", \"child\": { \"value\" : \"p1_child1\"} }\n\nor\n\n\"customfield_11447\" : { \"id\": 10112, \"child\": { \"id\" : 10115 } }\n\n```\n\n**Multi-select custom field** - _A custom UI field that enables multiple values to be selected from a defined list of values, with values addressed by `value` or `id`._\n\n```json\n\n\"customfield_11448\" : [ { \"value\": \"option1\" }, { \"value\": \"option2\" } ]\n\nor\n\n\"customfield_11448\" : [ { \"id\": 10112 }, { \"id\": 10115 } ]\n\n```\n\n**Single-select custom field** - _A custom UI field that enables a single value to be selected from a defined list of values, with values address by `value` or `id`._\n\n```json\n\n\"customfield_11449\" : { \"value\": \"option3\" }\n\nor\n\n\"customfield_11449\" : { \"id\": 10112 }\n\n```\n\n**Multi-line text custom field** - _A custom UI field that enables multiple lines of text to be entered._\n\n```json\n\n\"customfield_11450\": \"Multiples lines of text\\n separated by\\n line feeds\"\n\n```\n\n**Text custom field** - _A custom UI field that enables a single line of text to be entered._\n\n```json\n\n\"customfield_11450\": \"A single line of text.\"\n\n```\n\n**URL custom field** - _A custom UI field that enables a URL to be entered._\n\n```json\n\n\"customfield_11452\" : \"http://www.atlassian.com\",\n\n```\n\n**Single-user picker custom field** - _A custom UI field that enables a single user to be selected._\n\n```json\n\n\"customfield_11453\" : { \"name\":\"tommytomtomahawk\" },\n\n```\n\n**Multi-user picker custom field** - _A custom UI field that enables multiple users to be selected._\n\n```json\n\n\"customfield_11458\" : [ { \"name\":\"inigomontoya\" }, { \"name\":\"tommytomtomahawk\" }]\n\n```\n\n**Attachment** - _Attachments, using IDs of temporary attachments as provided by the /attachTemporaryFile API._\n\n````json\n\"attachment\" : [\"4786e3a5-52be-4d5b-bf3d-5f53e54f4559\", \"1187b2b7-8a75-4eac-88b2-b6e43129ef5c\"]\n\n````"},{"title":"Resource summary","anchor":"overshort","body":"The Jira Service Desk REST API enable you to work with a range of objects from the Jira Service Desk. The main resources provided are:\n\n| Resource      | Description                                                                                                                                                                                                                                    |\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| customer      | This resource represents customers within your Jira instance. Use it to create new customers.                                                                                                                                                  |\n| info          | This resource provides details of the Jira Service Desk software version, builds, and related links.                                                                                                                                           |\n| organization  | This resource enables you to group Jira Service Desk customers together. Use it to create and delete organizations, and add and remove customers from them.                                                                                    |\n| request       | This resource represents the customer requests in your service desks. Use it to create new requests and update request details, such as attachments and comments as well as take actions to update request status or review SLA performance.   |\n| requesttype   | This resource enables a list of customer request types, a way to categorize requests in a service desk, to be obtained.                                                                                                                        |\n| servicedesk   | This resource represents a service desk. Use it to retrieve the service desks in your Jira instance, managed the requests service desks can handle, manage the associated customers and organizations, and retrieve details of request queues. |\n"}]}}