@resolution/jira-api-client 0.4.6 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +27 -4
  3. package/lib/index.d.ts +13 -0
  4. package/lib/index.js +17 -1
  5. package/lib/index.js.map +1 -1
  6. package/lib/openapi/platform/BaseJiraPlatformApiClient.d.ts +1 -1
  7. package/lib/openapi/platform/BaseJiraPlatformApiClient.js +1 -1
  8. package/lib/openapi/platform/services/DashboardsService.d.ts +7 -1
  9. package/lib/openapi/platform/services/DashboardsService.js +4 -1
  10. package/lib/openapi/platform/services/DashboardsService.js.map +1 -1
  11. package/lib/openapi/platform/services/IssueSearchService.d.ts +8 -1
  12. package/lib/openapi/platform/services/IssueSearchService.js +2 -1
  13. package/lib/openapi/platform/services/IssueSearchService.js.map +1 -1
  14. package/lib/openapi/platform/services/IssuesService.d.ts +8 -1
  15. package/lib/openapi/platform/services/IssuesService.js +2 -1
  16. package/lib/openapi/platform/services/IssuesService.js.map +1 -1
  17. package/lib/openapi/platform/services/PermissionsService.d.ts +7 -0
  18. package/lib/openapi/platform/services/PermissionsService.js +7 -0
  19. package/lib/openapi/platform/services/PermissionsService.js.map +1 -1
  20. package/lib/openapi/serviceManagement/BaseJiraServiceManagementApiClient.d.ts +46 -0
  21. package/lib/openapi/serviceManagement/BaseJiraServiceManagementApiClient.js +78 -0
  22. package/lib/openapi/serviceManagement/BaseJiraServiceManagementApiClient.js.map +1 -0
  23. package/lib/openapi/serviceManagement/core/CommonHttpClient.d.ts +196 -0
  24. package/lib/openapi/serviceManagement/core/CommonHttpClient.js +390 -0
  25. package/lib/openapi/serviceManagement/core/CommonHttpClient.js.map +1 -0
  26. package/lib/openapi/serviceManagement/core/CommonHttpService.d.ts +9 -0
  27. package/lib/openapi/serviceManagement/core/CommonHttpService.js +29 -0
  28. package/lib/openapi/serviceManagement/core/CommonHttpService.js.map +1 -0
  29. package/lib/openapi/serviceManagement/core/CommonValidationSchemaStorage.d.ts +35 -0
  30. package/lib/openapi/serviceManagement/core/CommonValidationSchemaStorage.js +65 -0
  31. package/lib/openapi/serviceManagement/core/CommonValidationSchemaStorage.js.map +1 -0
  32. package/lib/openapi/serviceManagement/models/assets.d.ts +54 -0
  33. package/lib/openapi/serviceManagement/models/assets.js +60 -0
  34. package/lib/openapi/serviceManagement/models/assets.js.map +1 -0
  35. package/lib/openapi/serviceManagement/models/common.d.ts +228 -0
  36. package/lib/openapi/serviceManagement/models/common.js +172 -0
  37. package/lib/openapi/serviceManagement/models/common.js.map +1 -0
  38. package/lib/openapi/serviceManagement/models/customer.d.ts +30 -0
  39. package/lib/openapi/serviceManagement/models/customer.js +27 -0
  40. package/lib/openapi/serviceManagement/models/customer.js.map +1 -0
  41. package/lib/openapi/serviceManagement/models/info.d.ts +18 -0
  42. package/lib/openapi/serviceManagement/models/info.js +24 -0
  43. package/lib/openapi/serviceManagement/models/info.js.map +1 -0
  44. package/lib/openapi/serviceManagement/models/knowledgebase.d.ts +24 -0
  45. package/lib/openapi/serviceManagement/models/knowledgebase.js +32 -0
  46. package/lib/openapi/serviceManagement/models/knowledgebase.js.map +1 -0
  47. package/lib/openapi/serviceManagement/models/organization.d.ts +76 -0
  48. package/lib/openapi/serviceManagement/models/organization.js +65 -0
  49. package/lib/openapi/serviceManagement/models/organization.js.map +1 -0
  50. package/lib/openapi/serviceManagement/models/request.d.ts +594 -0
  51. package/lib/openapi/serviceManagement/models/request.js +516 -0
  52. package/lib/openapi/serviceManagement/models/request.js.map +1 -0
  53. package/lib/openapi/serviceManagement/models/servicedesk.d.ts +525 -0
  54. package/lib/openapi/serviceManagement/models/servicedesk.js +442 -0
  55. package/lib/openapi/serviceManagement/models/servicedesk.js.map +1 -0
  56. package/lib/openapi/serviceManagement/services/AssetsService.d.ts +61 -0
  57. package/lib/openapi/serviceManagement/services/AssetsService.js +113 -0
  58. package/lib/openapi/serviceManagement/services/AssetsService.js.map +1 -0
  59. package/lib/openapi/serviceManagement/services/CustomerService.d.ts +63 -0
  60. package/lib/openapi/serviceManagement/services/CustomerService.js +93 -0
  61. package/lib/openapi/serviceManagement/services/CustomerService.js.map +1 -0
  62. package/lib/openapi/serviceManagement/services/InfoService.d.ts +34 -0
  63. package/lib/openapi/serviceManagement/services/InfoService.js +71 -0
  64. package/lib/openapi/serviceManagement/services/InfoService.js.map +1 -0
  65. package/lib/openapi/serviceManagement/services/KnowledgebaseService.d.ts +81 -0
  66. package/lib/openapi/serviceManagement/services/KnowledgebaseService.js +106 -0
  67. package/lib/openapi/serviceManagement/services/KnowledgebaseService.js.map +1 -0
  68. package/lib/openapi/serviceManagement/services/OrganizationService.d.ts +589 -0
  69. package/lib/openapi/serviceManagement/services/OrganizationService.js +762 -0
  70. package/lib/openapi/serviceManagement/services/OrganizationService.js.map +1 -0
  71. package/lib/openapi/serviceManagement/services/RequestService.d.ts +2736 -0
  72. package/lib/openapi/serviceManagement/services/RequestService.js +3056 -0
  73. package/lib/openapi/serviceManagement/services/RequestService.js.map +1 -0
  74. package/lib/openapi/serviceManagement/services/RequesttypeService.d.ts +166 -0
  75. package/lib/openapi/serviceManagement/services/RequesttypeService.js +190 -0
  76. package/lib/openapi/serviceManagement/services/RequesttypeService.js.map +1 -0
  77. package/lib/openapi/serviceManagement/services/ServicedeskService.d.ts +1268 -0
  78. package/lib/openapi/serviceManagement/services/ServicedeskService.js +1510 -0
  79. package/lib/openapi/serviceManagement/services/ServicedeskService.js.map +1 -0
  80. package/lib/openapi/serviceManagement/validationSchemaStorage.d.ts +3 -0
  81. package/lib/openapi/serviceManagement/validationSchemaStorage.js +144 -0
  82. package/lib/openapi/serviceManagement/validationSchemaStorage.js.map +1 -0
  83. package/package.json +3 -3
@@ -0,0 +1,1268 @@
1
+ import { CommonHttpService } from "../core/CommonHttpService";
2
+ import { type CustomerRequestCreateMetaDto, type EntityProperty, type PagedDtoArticleDto, type PagedDtoRequestTypeDto, type PagedDtoUserDto, type PropertyKeys, type RequestTypeDto, type ServiceDeskDto } from "../models/common";
3
+ import { type MultipartFile, type PagedDtoIssueBean, type PagedDtoQueueDto, type PagedDtoRequestTypeGroupDto, type PagedDtoServiceDeskDto, type QueueDto, type RequestTypeCreateDto, type ServiceDeskCustomerDto } from "../models/servicedesk";
4
+ /** @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk */
5
+ export declare class ServicedeskService extends CommonHttpService {
6
+ /**
7
+ * Adds one or more customers to a service desk. If any of the passed customers
8
+ * are associated with the service desk, no changes will be made for those
9
+ * customers and the resource returns a 204 success code.
10
+ *
11
+ * **[Permissions](#permissions) required**: Service desk administrator
12
+ *
13
+ * @path {POST} /rest/servicedeskapi/servicedesk/{serviceDeskId}/customer
14
+ * @scopes-current manage:servicedesk-customer
15
+ * @scopes-beta read:servicedesk.customer:jira-service-management,
16
+ * write:servicedesk.customer:jira-service-management
17
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-customer-post
18
+ */
19
+ addCustomers: ({ serviceDeskId, serviceDeskCustomerDto, }: {
20
+ /**
21
+ * The ID of the service desk the customer list should be returned from. This can
22
+ * alternatively be a [project identifier.](#project-identifiers)
23
+ */
24
+ serviceDeskId: string;
25
+ /**
26
+ * @example {
27
+ * "accountIds": [
28
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
29
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd",
30
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"
31
+ * ],
32
+ * "usernames": [
33
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
34
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd",
35
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"
36
+ * ]
37
+ * }
38
+ */
39
+ serviceDeskCustomerDto: ServiceDeskCustomerDto;
40
+ }) => Promise<void>;
41
+ /**
42
+ * This method adds one or more temporary attachments to a service desk, which can
43
+ * then be permanently attached to a customer request using
44
+ * [servicedeskapi/request/\{issueIdOrKey\}/attachment](#api-request-issueIdOrKey-attachment-post).
45
+ *
46
+ * **Note**: It is possible for a service desk administrator to turn off the
47
+ * ability to add attachments to a service desk.
48
+ *
49
+ * This method expects a multipart request. The media-type multipart/form-data is
50
+ * defined in RFC 1867. Most client libraries have classes that make dealing with
51
+ * multipart posts simple. For instance, in Java the Apache HTTP Components
52
+ * library provides
53
+ * [MultiPartEntity](http://hc.apache.org/httpcomponents-client-ga/httpmime/apidocs/org/apache/http/entity/mime/MultipartEntity.html).
54
+ *
55
+ * Because this method accepts multipart/form-data, it has XSRF protection on it.
56
+ * This means you must submit a header of X-Atlassian-Token: no-check with the
57
+ * request or it will be blocked.
58
+ *
59
+ * The name of the multipart/form-data parameter that contains the attachments
60
+ * must be `file`.
61
+ *
62
+ * For example, to upload a file called `myfile.txt` in the Service Desk with ID
63
+ * 10001 use
64
+ *
65
+ * curl -D- -u customer:customer -X POST -H "X-ExperimentalApi: opt-in" -H
66
+ * "X-Atlassian-Token: no-check" -F "file=@myfile.txt"
67
+ * https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001/attachTemporaryFile
68
+ *
69
+ * **[Permissions](#permissions) required**: Permission to add attachments in this
70
+ * Service Desk.
71
+ *
72
+ * @returns Returns if the file(s) were attached.
73
+ *
74
+ * example: {
75
+ * "temporaryAttachments": [
76
+ * {
77
+ * "temporaryAttachmentId": "temp8186986881700442965",
78
+ * "fileName": "atlassian.png"
79
+ * },
80
+ * {
81
+ * "temporaryAttachmentId": "temp589064256337898328",
82
+ * "fileName": "readme.txt"
83
+ * }
84
+ * ]
85
+ * }
86
+ * @path {POST} /rest/servicedeskapi/servicedesk/{serviceDeskId}/attachTemporaryFile
87
+ * @scopes-current write:servicedesk-request
88
+ * @scopes-beta read:request.attachment:jira-service-management,
89
+ * write:request.attachment:jira-service-management
90
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-attachtemporaryfile-post
91
+ */
92
+ attachTemporaryFile: ({ serviceDeskId, multipartFiles, }: {
93
+ /**
94
+ * The ID of the Service Desk to which the file will be attached. This can
95
+ * alternatively be a [project identifier.](#project-identifiers)
96
+ */
97
+ serviceDeskId: string;
98
+ multipartFiles: MultipartFile[];
99
+ }) => Promise<unknown>;
100
+ /**
101
+ * This method enables a customer request type to be added to a service desk based
102
+ * on an issue type. Note that not all customer request type fields can be
103
+ * specified in the request and these fields are given the following default
104
+ * values:
105
+ *
106
+ * * Request type icon is given the headset icon.
107
+ * * Request type groups is left empty, which means this customer request type
108
+ * will not be visible on the [customer
109
+ * portal](https://confluence.atlassian.com/servicedeskcloud/configuring-the-customer-portal-732528918.html).
110
+ * * Request type status mapping is left empty, so the request type has no
111
+ * custom status mapping but inherits the status map from the issue type upon
112
+ * which it is based.
113
+ * * Request type field mapping is set to show the required fields as specified
114
+ * by the issue type used to create the customer request type.
115
+ *
116
+ *
117
+ * These fields can be updated by a service desk administrator using the **Request
118
+ * types** option in **Project settings**.
119
+ * Request Types are created in next-gen projects by creating Issue Types. Please
120
+ * use the Jira Cloud Platform Create issue type endpoint instead.
121
+ *
122
+ * **[Permissions](#permissions) required**: Service desk's administrator
123
+ *
124
+ * @returns Returns the customer request type created.
125
+ *
126
+ * example: {
127
+ * "_expands": [],
128
+ * "id": "11001",
129
+ * "_links": {
130
+ * "self":
131
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001"
132
+ * },
133
+ * "name": "Get IT Help",
134
+ * "description": "Get IT Help",
135
+ * "helpText": "Please tell us clearly the problem you have within 100 words.",
136
+ * "issueTypeId": "12345",
137
+ * "serviceDeskId": "28",
138
+ * "portalId": "2",
139
+ * "groupIds": [
140
+ * "12"
141
+ * ],
142
+ * "icon": {
143
+ * "id": "12345",
144
+ * "_links": {
145
+ * "iconUrls": {
146
+ * "48x48":
147
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=large",
148
+ * "24x24":
149
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=small",
150
+ * "16x16":
151
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=xsmall",
152
+ * "32x32":
153
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=medium"
154
+ * }
155
+ * }
156
+ * }
157
+ * }
158
+ * @path {POST} /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype
159
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-post
160
+ */
161
+ createRequestType: ({ serviceDeskId, requestTypeCreateDto, }: {
162
+ /**
163
+ * The ID of the service desk where the customer request type is to be created.
164
+ * This can alternatively be a [project identifier.](#project-identifiers)
165
+ */
166
+ serviceDeskId: string;
167
+ /**
168
+ * @example {
169
+ * "description": "Get IT Help",
170
+ * "helpText": "Please tell us clearly the problem you have within 100 words.",
171
+ * "issueTypeId": "12345",
172
+ * "name": "Get IT Help"
173
+ * }
174
+ */
175
+ requestTypeCreateDto: RequestTypeCreateDto;
176
+ }) => Promise<RequestTypeDto>;
177
+ /**
178
+ * Removes a property from a request type.
179
+ *
180
+ * Properties for a Request Type in next-gen are stored as Issue Type properties
181
+ * and therefore can also be deleted by calling the Jira Cloud Platform [Delete
182
+ * issue type
183
+ * property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-delete)
184
+ * endpoint.
185
+ *
186
+ * **[Permissions](#permissions) required**: Jira project administrator with a
187
+ * Jira Service Management agent license.
188
+ *
189
+ * @path {DELETE}
190
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property/{propertyKey}
191
+ * @scopes-current manage:jira-project
192
+ * @scopes-beta read:requesttype.property:jira-service-management,
193
+ * delete:requesttype.property:jira-service-management
194
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-property-propertykey-delete
195
+ */
196
+ deleteProperty: ({ serviceDeskId, requestTypeId, propertyKey, }: {
197
+ /**
198
+ * The ID of the service desk which contains the request type. This can
199
+ * alternatively be a [project identifier.](#project-identifiers)
200
+ */
201
+ serviceDeskId: string;
202
+ /** The ID of the request type for which the property will be removed. */
203
+ requestTypeId: number;
204
+ /** The key of the property to remove. */
205
+ propertyKey: string;
206
+ }) => Promise<void>;
207
+ /**
208
+ * This method deletes a customer request type from a service desk, and removes it
209
+ * from all customer requests.
210
+ * This only supports classic projects.
211
+ *
212
+ * **[Permissions](#permissions) required**: Service desk administrator.
213
+ *
214
+ * @path {DELETE}
215
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}
216
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-delete
217
+ */
218
+ deleteRequestType: ({ serviceDeskId, requestTypeId, }: {
219
+ /** The ID or [project identifier](#project-identifiers) of the service desk. */
220
+ serviceDeskId: string;
221
+ /** The ID of the request type. */
222
+ requestTypeId: number;
223
+ }) => Promise<void>;
224
+ /**
225
+ * Returns articles which match the given query and belong to the knowledge base
226
+ * linked to the service desk.
227
+ *
228
+ * **[Permissions](#permissions) required**: Permission to access the service desk.
229
+ *
230
+ * @returns Returns the articles, on the specified page of the results.
231
+ *
232
+ * example: {
233
+ * "_expands": [],
234
+ * "size": 2,
235
+ * "start": 2,
236
+ * "limit": 2,
237
+ * "isLastPage": false,
238
+ * "_links": {
239
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
240
+ * "context": "context",
241
+ * "next":
242
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/%7BserviceDeskId%7D/knowledgebase/article?start=4&limit=2",
243
+ * "prev":
244
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/%7BserviceDeskId%7D/knowledgebase/article?start=0&limit=2"
245
+ * },
246
+ * "values": [
247
+ * {
248
+ * "title": "Stolen computer",
249
+ * "excerpt": "assuming your computer was stolen",
250
+ * "source": {
251
+ * "type": "confluence",
252
+ * "pageId": "8786177",
253
+ * "spaceKey": "IT"
254
+ * },
255
+ * "content": {
256
+ * "iframeSrc":
257
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8786177"
258
+ * }
259
+ * },
260
+ * {
261
+ * "title": "Upgrading computer",
262
+ * "excerpt": "each computer older then 3 years can be upgraded",
263
+ * "source": {
264
+ * "type": "confluence",
265
+ * "pageId": "8785228",
266
+ * "spaceKey": "IT"
267
+ * },
268
+ * "content": {
269
+ * "iframeSrc":
270
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/knowledgebase/article/view/8785228"
271
+ * }
272
+ * }
273
+ * ]
274
+ * }
275
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/knowledgebase/article
276
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-knowledgebase-article-get
277
+ */
278
+ getArticles: ({ serviceDeskId, query, highlight, start, limit, }: {
279
+ serviceDeskId: string;
280
+ /** The string used to filter the articles (required). */
281
+ query: string;
282
+ /**
283
+ * If set to true matching query term in the title and excerpt will be highlighted
284
+ * using the `@@@hl@@@term@@@endhl@@@` syntax. Default: false.
285
+ */
286
+ highlight?: boolean | undefined;
287
+ /**
288
+ * The starting index of the returned objects. Base index: 0. See the
289
+ * [Pagination](#pagination) section for more details.
290
+ */
291
+ start?: number | undefined;
292
+ /**
293
+ * The maximum number of items to return per page. Default: 50. See the
294
+ * [Pagination](#pagination) section for more details.
295
+ */
296
+ limit?: number | undefined;
297
+ }) => Promise<PagedDtoArticleDto>;
298
+ /**
299
+ * This method returns a list of the customers on a service desk.
300
+ *
301
+ * The returned list of customers can be filtered using the `query` parameter. The
302
+ * parameter is matched against customers' `displayName`, `name`, or `email`. For
303
+ * example, searching for "John", "Jo", "Smi", or "Smith" will match a user with
304
+ * display name "John Smith".
305
+ *
306
+ * **[Permissions](#permissions) required**: Permission to view this Service
307
+ * Desk's customers.
308
+ *
309
+ * @returns Returns the service desk's customer list.
310
+ *
311
+ * example: {
312
+ * "_expands": [],
313
+ * "size": 1,
314
+ * "start": 1,
315
+ * "limit": 1,
316
+ * "isLastPage": false,
317
+ * "_links": {
318
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
319
+ * "context": "context",
320
+ * "next":
321
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/customer?start=2&limit=1",
322
+ * "prev":
323
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/customer?start=0&limit=1"
324
+ * },
325
+ * "values": [
326
+ * {
327
+ * "accountId":
328
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
329
+ * "name": "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
330
+ * "key": "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
331
+ * "emailAddress": "fred@example.com",
332
+ * "displayName": "Fred F. User",
333
+ * "active": true,
334
+ * "timeZone": "Australia/Sydney",
335
+ * "_links": {
336
+ * "jiraRest":
337
+ * "https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
338
+ * "avatarUrls": {
339
+ * "16x16":
340
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue",
341
+ * "24x24":
342
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue",
343
+ * "32x32":
344
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue",
345
+ * "48x48":
346
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue"
347
+ * },
348
+ * "self":
349
+ * "https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"
350
+ * }
351
+ * }
352
+ * ]
353
+ * }
354
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/customer
355
+ * @scopes-current manage:servicedesk-customer
356
+ * @scopes-beta read:servicedesk.customer:jira-service-management, read:user:jira
357
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-customer-get
358
+ */
359
+ getCustomers: ({ serviceDeskId, query, start, limit, }: {
360
+ /**
361
+ * The ID of the service desk the customer list should be returned from. This can
362
+ * alternatively be a [project identifier.](#project-identifiers)
363
+ */
364
+ serviceDeskId: string;
365
+ /** The string used to filter the customer list. */
366
+ query?: string | undefined;
367
+ /**
368
+ * The starting index of the returned objects. Base index: 0. See the
369
+ * [Pagination](#pagination) section for more details.
370
+ */
371
+ start?: number | undefined;
372
+ /**
373
+ * The maximum number of users to return per page. Default: 50. See the
374
+ * [Pagination](#pagination) section for more details.
375
+ */
376
+ limit?: number | undefined;
377
+ }) => Promise<PagedDtoUserDto>;
378
+ /**
379
+ * This method returns the customer requests in a queue. Only fields that the
380
+ * queue is configured to show are returned. For example, if a queue is configured
381
+ * to show description and due date, then only those two fields are returned for
382
+ * each customer request in the queue.
383
+ *
384
+ * **[Permissions](#permissions) required**: Service desk's agent.
385
+ *
386
+ * @returns Returns the customer requests belonging to the queue, on the specified page of
387
+ * the results.
388
+ *
389
+ * example: {
390
+ * "_expands": [],
391
+ * "size": 1,
392
+ * "start": 1,
393
+ * "limit": 1,
394
+ * "isLastPage": false,
395
+ * "_links": {
396
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
397
+ * "context": "context",
398
+ * "next":
399
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10/issue?start=2&limit=1",
400
+ * "prev":
401
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10/issue?start=0&limit=1"
402
+ * },
403
+ * "values": [
404
+ * {
405
+ * "fields": {
406
+ * "summary": "My keyboard is broken",
407
+ * "issuetype": {
408
+ * "avatarId": 10002,
409
+ * "description": "For general IT problems and questions. Created by
410
+ * Jira Service Management.",
411
+ * "iconUrl":
412
+ * "https://your-domain.atlassian.net/servicedesk/issue-type-icons?icon=it-help",
413
+ * "id": "13",
414
+ * "name": "IT Help",
415
+ * "self": "https://your-domain.atlassian.net/rest/api/2/issuetype/13",
416
+ * "subtask": false
417
+ * },
418
+ * "duedate": "2015-11-11T14:17:13.000+0700",
419
+ * "created": "2015-11-09T14:17:13.000+0700",
420
+ * "reporter": {
421
+ * "accountId":
422
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
423
+ * "name":
424
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
425
+ * "key":
426
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
427
+ * "emailAddress": "fred@example.com",
428
+ * "displayName": "Fred F. User",
429
+ * "active": true,
430
+ * "timeZone": "Australia/Sydney",
431
+ * "_links": {
432
+ * "jiraRest":
433
+ * "https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
434
+ * "avatarUrls": {
435
+ * "16x16":
436
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=16&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D16%26noRedirect%3Dtrue",
437
+ * "24x24":
438
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=24&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D24%26noRedirect%3Dtrue",
439
+ * "32x32":
440
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=32&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D32%26noRedirect%3Dtrue",
441
+ * "48x48":
442
+ * "https://avatar-cdn.atlassian.com/9bc3b5bcb0db050c6d7660b28a5b86c9?s=48&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2F9bc3b5bcb0db050c6d7660b28a5b86c9%3Fd%3Dmm%26s%3D48%26noRedirect%3Dtrue"
443
+ * },
444
+ * "self":
445
+ * "https://your-domain.atlassian.net/rest/api/2/user?username=qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b"
446
+ * }
447
+ * }
448
+ * },
449
+ * "id": "10001",
450
+ * "key": "SD-1",
451
+ * "self":
452
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/rest/api/2/issue/10001"
453
+ * }
454
+ * ]
455
+ * }
456
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/queue/{queueId}/issue
457
+ * @scopes-current read:jira-work
458
+ * @scopes-beta read:queue:jira-service-management, read:user:jira, read:issue:jira
459
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-queue-queueid-issue-get
460
+ */
461
+ getIssuesInQueue: ({ serviceDeskId, queueId, start, limit, }: {
462
+ /**
463
+ * The ID of the service desk containing the queue to be queried. This can
464
+ * alternatively be a [project identifier.](#project-identifiers)
465
+ */
466
+ serviceDeskId: string;
467
+ /** The ID of the queue whose customer requests will be returned. */
468
+ queueId: number;
469
+ /**
470
+ * The starting index of the returned objects. Base index: 0. See the
471
+ * [Pagination](#pagination) section for more details.
472
+ */
473
+ start?: number | undefined;
474
+ /**
475
+ * The maximum number of items to return per page. Default: 50. See the
476
+ * [Pagination](#pagination) section for more details.
477
+ */
478
+ limit?: number | undefined;
479
+ }) => Promise<PagedDtoIssueBean>;
480
+ /**
481
+ * Returns the keys of all properties for a request type.
482
+ *
483
+ * Properties for a Request Type in next-gen are stored as Issue Type properties
484
+ * and therefore the keys of all properties for a request type are also available
485
+ * by calling the Jira Cloud Platform [Get issue type property
486
+ * keys](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-get)
487
+ * endpoint.
488
+ *
489
+ * **[Permissions](#permissions) required**: The user must have permission to view
490
+ * the request type.
491
+ *
492
+ * @returns Returned if the request type was found.
493
+ *
494
+ * example: {
495
+ * "entityPropertyKeyBeans": [
496
+ * {
497
+ * "key": "requestType.attributes",
498
+ * "self":
499
+ * "/rest/servicedeskapi/servicedesk/1/requestType/2/property/propertyKey"
500
+ * }
501
+ * ]
502
+ * }
503
+ * @path {GET}
504
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property
505
+ * @scopes-current read:servicedesk-request
506
+ * @scopes-beta read:requesttype.property:jira-service-management
507
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-property-get
508
+ */
509
+ getPropertiesKeys: ({ requestTypeId, serviceDeskId, }: {
510
+ /** The ID of the request type for which keys will be retrieved. */
511
+ requestTypeId: number;
512
+ /**
513
+ * The ID of the service desk which contains the request type. This can
514
+ * alternatively be a [project identifier.](#project-identifiers)
515
+ */
516
+ serviceDeskId: string;
517
+ }) => Promise<PropertyKeys>;
518
+ /**
519
+ * Returns the value of the property from a request type.
520
+ *
521
+ * Properties for a Request Type in next-gen are stored as Issue Type properties
522
+ * and therefore also available by calling the Jira Cloud Platform [Get issue type
523
+ * property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-get)
524
+ * endpoint.
525
+ *
526
+ * **[Permissions](#permissions) required**: User must have permission to view the
527
+ * request type.
528
+ *
529
+ * @returns Returned if the request type property was returned.
530
+ *
531
+ * example: {
532
+ * "key": "organization.attributes",
533
+ * "value": {
534
+ * "color": "green",
535
+ * "priority": "high"
536
+ * }
537
+ * }
538
+ * @path {GET}
539
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property/{propertyKey}
540
+ * @scopes-current read:servicedesk-request
541
+ * @scopes-beta read:requesttype.property:jira-service-management
542
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-property-propertykey-get
543
+ */
544
+ getProperty: ({ serviceDeskId, requestTypeId, propertyKey, }: {
545
+ /**
546
+ * The ID of the service desk which contains the request type. This can
547
+ * alternatively be a [project identifier.](#project-identifiers)
548
+ */
549
+ serviceDeskId: string;
550
+ /** The ID of the request type from which the property will be retrieved. */
551
+ requestTypeId: number;
552
+ /** The key of the property to return. */
553
+ propertyKey: string;
554
+ }) => Promise<EntityProperty>;
555
+ /**
556
+ * This method returns a specific queues in a service desk. To include a customer
557
+ * request count for the queue (in the `issueCount` field) in the response, set
558
+ * the query parameter `includeCount` to true (its default is false).
559
+ *
560
+ * **[Permissions](#permissions) required**: service desk's Agent.
561
+ *
562
+ * @returns Returns the specific queue of the service desk.
563
+ *
564
+ * example: {
565
+ * "id": "20",
566
+ * "name": "Assigned to me",
567
+ * "jql": "project = SD AND assignee = currentUser() AND resolution = Unresolved
568
+ * ORDER BY \"Time to resolution\" ASC",
569
+ * "fields": [
570
+ * "issuetype",
571
+ * "issuekey",
572
+ * "summary",
573
+ * "created",
574
+ * "reporter",
575
+ * "duedate"
576
+ * ],
577
+ * "issueCount": 10,
578
+ * "_links": {
579
+ * "self":
580
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/20"
581
+ * }
582
+ * }
583
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/queue/{queueId}
584
+ * @scopes-current read:jira-work
585
+ * @scopes-beta read:queue:jira-service-management, read:user:jira, read:jql:jira
586
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-queue-queueid-get
587
+ */
588
+ getQueue: ({ serviceDeskId, queueId, includeCount, }: {
589
+ /**
590
+ * ID of the service desk whose queues will be returned. This can alternatively be
591
+ * a [project identifier.](#project-identifiers)
592
+ */
593
+ serviceDeskId: string;
594
+ /** ID of the required queue. */
595
+ queueId: number;
596
+ /**
597
+ * Specifies whether to include each queue's customer request (issue) count in the
598
+ * response.
599
+ */
600
+ includeCount?: boolean | undefined;
601
+ }) => Promise<QueueDto>;
602
+ /**
603
+ * This method returns the queues in a service desk. To include a customer request
604
+ * count for each queue (in the `issueCount` field) in the response, set the query
605
+ * parameter `includeCount` to true (its default is false).
606
+ *
607
+ * **[Permissions](#permissions) required**: service desk's Agent.
608
+ *
609
+ * @returns Returns the queues of the service desk, on the specified page of the results.
610
+ *
611
+ * example: {
612
+ * "_expands": [],
613
+ * "size": 2,
614
+ * "start": 2,
615
+ * "limit": 2,
616
+ * "isLastPage": false,
617
+ * "_links": {
618
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
619
+ * "context": "context",
620
+ * "next":
621
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue?start=4&limit=2",
622
+ * "prev":
623
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue?start=0&limit=2"
624
+ * },
625
+ * "values": [
626
+ * {
627
+ * "id": "10",
628
+ * "name": "Unassigned issues",
629
+ * "jql": "project = SD AND assignee is EMPTY AND resolution = Unresolved
630
+ * ORDER BY \"Time to resolution\" ASC",
631
+ * "fields": [
632
+ * "issuetype",
633
+ * "issuekey",
634
+ * "summary",
635
+ * "created",
636
+ * "reporter",
637
+ * "duedate"
638
+ * ],
639
+ * "issueCount": 10,
640
+ * "_links": {
641
+ * "self":
642
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/10"
643
+ * }
644
+ * },
645
+ * {
646
+ * "id": "20",
647
+ * "name": "Assigned to me",
648
+ * "jql": "project = SD AND assignee = currentUser() AND resolution =
649
+ * Unresolved ORDER BY \"Time to resolution\" ASC",
650
+ * "fields": [
651
+ * "issuetype",
652
+ * "issuekey",
653
+ * "summary",
654
+ * "created",
655
+ * "reporter",
656
+ * "duedate"
657
+ * ],
658
+ * "issueCount": 10,
659
+ * "_links": {
660
+ * "self":
661
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/1/queue/20"
662
+ * }
663
+ * }
664
+ * ]
665
+ * }
666
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/queue
667
+ * @scopes-current read:jira-work
668
+ * @scopes-beta read:queue:jira-service-management, read:user:jira, read:jql:jira
669
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-queue-get
670
+ */
671
+ getQueues: ({ serviceDeskId, includeCount, start, limit, }: {
672
+ /**
673
+ * ID of the service desk whose queues will be returned. This can alternatively be
674
+ * a [project identifier.](#project-identifiers)
675
+ */
676
+ serviceDeskId: string;
677
+ /**
678
+ * Specifies whether to include each queue's customer request (issue) count in the
679
+ * response.
680
+ */
681
+ includeCount?: boolean | undefined;
682
+ /**
683
+ * The starting index of the returned objects. Base index: 0. See the
684
+ * [Pagination](#pagination) section for more details.
685
+ */
686
+ start?: number | undefined;
687
+ /**
688
+ * The maximum number of items to return per page. Default: 50. See the
689
+ * [Pagination](#pagination) section for more details.
690
+ */
691
+ limit?: number | undefined;
692
+ }) => Promise<PagedDtoQueueDto>;
693
+ /**
694
+ * This method returns a customer request type from a service desk.
695
+ *
696
+ * This operation can be accessed anonymously.
697
+ *
698
+ * **[Permissions](#permissions) required**: Permission to access the service desk.
699
+ *
700
+ * @returns Returns the customer request type item.
701
+ *
702
+ * example: {
703
+ * "_expands": [],
704
+ * "id": "11001",
705
+ * "_links": {
706
+ * "self":
707
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001"
708
+ * },
709
+ * "name": "Get IT Help",
710
+ * "description": "Get IT Help",
711
+ * "helpText": "Please tell us clearly the problem you have within 100 words.",
712
+ * "issueTypeId": "12345",
713
+ * "serviceDeskId": "28",
714
+ * "portalId": "2",
715
+ * "groupIds": [
716
+ * "12"
717
+ * ],
718
+ * "icon": {
719
+ * "id": "12345",
720
+ * "_links": {
721
+ * "iconUrls": {
722
+ * "48x48":
723
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=large",
724
+ * "24x24":
725
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=small",
726
+ * "16x16":
727
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=xsmall",
728
+ * "32x32":
729
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=medium"
730
+ * }
731
+ * }
732
+ * }
733
+ * }
734
+ * @path {GET}
735
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}
736
+ * @scopes-current read:servicedesk-request
737
+ * @scopes-beta read:requesttype:jira-service-management
738
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-get
739
+ */
740
+ getRequestTypeById: ({ serviceDeskId, requestTypeId, expand, }: {
741
+ /**
742
+ * The ID of the service desk whose customer request type is to be returned. This
743
+ * can alternatively be a [project identifier.](#project-identifiers)
744
+ */
745
+ serviceDeskId: string;
746
+ /** The ID of the customer request type to be returned. */
747
+ requestTypeId: string;
748
+ expand?: string[] | undefined;
749
+ }) => Promise<RequestTypeDto>;
750
+ /**
751
+ * This method returns the fields for a service desk's customer request type.
752
+ *
753
+ * Also, the following information about the user's permissions for the request
754
+ * type is returned:
755
+ *
756
+ * * `canRaiseOnBehalfOf` returns `true` if the user has permission to raise
757
+ * customer requests on behalf of other customers. Otherwise, returns `false`.
758
+ * * `canAddRequestParticipants` returns `true` if the user can add customer
759
+ * request participants. Otherwise, returns `false`.
760
+ *
761
+ * **[Permissions](#permissions) required**: Permission to view the Service Desk.
762
+ * However, hidden fields would be visible to only Service desk's Administrator.
763
+ *
764
+ * @returns Returns the request type's fields and user permission details, on the specified
765
+ * page of the results.
766
+ *
767
+ * example: {
768
+ * "canAddRequestParticipants": true,
769
+ * "canRaiseOnBehalfOf": true,
770
+ * "requestTypeFields": [
771
+ * {
772
+ * "fieldId": "summary",
773
+ * "jiraSchema": {
774
+ * "system": "summary",
775
+ * "type": "string"
776
+ * },
777
+ * "name": "What do you need?",
778
+ * "required": true,
779
+ * "validValues": [],
780
+ * "visible": true
781
+ * },
782
+ * {
783
+ * "fieldId": "customfield_10000",
784
+ * "jiraSchema": {
785
+ * "custom":
786
+ * "com.atlassian.jira.plugin.system.customfieldtypes:userpicker",
787
+ * "customId": 10000,
788
+ * "type": "user"
789
+ * },
790
+ * "name": "Nominee",
791
+ * "required": true,
792
+ * "validValues": [],
793
+ * "visible": true
794
+ * },
795
+ * {
796
+ * "fieldId": "customfield_10001",
797
+ * "jiraSchema": {
798
+ * "custom":
799
+ * "com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons",
800
+ * "customId": 10001,
801
+ * "type": "string"
802
+ * },
803
+ * "name": "Gifts",
804
+ * "required": true,
805
+ * "validValues": [
806
+ * {
807
+ * "children": [],
808
+ * "label": "Bottle of Wine",
809
+ * "value": "10000"
810
+ * },
811
+ * {
812
+ * "children": [],
813
+ * "label": "Threadless Voucher",
814
+ * "value": "10001"
815
+ * },
816
+ * {
817
+ * "children": [],
818
+ * "label": "2 Movie Tickets",
819
+ * "value": "10002"
820
+ * }
821
+ * ],
822
+ * "visible": false
823
+ * }
824
+ * ]
825
+ * }
826
+ * @path {GET}
827
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/field
828
+ * @scopes-current read:servicedesk-request
829
+ * @scopes-beta read:requesttype:jira-service-management
830
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-field-get
831
+ */
832
+ getRequestTypeFields: ({ serviceDeskId, requestTypeId, expand, }: {
833
+ /**
834
+ * The ID of the service desk containing the request types whose fields are to be
835
+ * returned. This can alternatively be a [project
836
+ * identifier.](#project-identifiers)
837
+ */
838
+ serviceDeskId: string;
839
+ /** The ID of the request types whose fields are to be returned. */
840
+ requestTypeId: number;
841
+ /**
842
+ * Use [expand](#expansion) to include additional information in the response.
843
+ * This parameter accepts `hiddenFields` that returns hidden fields associated
844
+ * with the request type.
845
+ */
846
+ expand?: string[] | undefined;
847
+ }) => Promise<CustomerRequestCreateMetaDto>;
848
+ /**
849
+ * This method returns a service desk's customer request type groups. Jira Service
850
+ * Management administrators can arrange the customer request type groups in an
851
+ * arbitrary order for display on the customer portal; the groups are returned in
852
+ * this order.
853
+ *
854
+ * **[Permissions](#permissions) required**: Permission to view the service desk.
855
+ *
856
+ * @returns Returns the service desk's customer request type groups, on the specified page
857
+ * of the results.
858
+ *
859
+ * example: {
860
+ * "_expands": [],
861
+ * "size": 3,
862
+ * "start": 3,
863
+ * "limit": 3,
864
+ * "isLastPage": false,
865
+ * "_links": {
866
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
867
+ * "context": "context",
868
+ * "next":
869
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/%7BserviceDeskId%7D/requesttypegroup?start=6&limit=3",
870
+ * "prev":
871
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/%7BserviceDeskId%7D/requesttypegroup?start=0&limit=3"
872
+ * },
873
+ * "values": [
874
+ * {
875
+ * "id": "12",
876
+ * "name": "Common Requests"
877
+ * },
878
+ * {
879
+ * "id": "13",
880
+ * "name": "Logins and Accounts"
881
+ * },
882
+ * {
883
+ * "id": "14",
884
+ * "name": "Servers and Infrastructure"
885
+ * }
886
+ * ]
887
+ * }
888
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttypegroup
889
+ * @scopes-current read:servicedesk-request
890
+ * @scopes-beta read:requesttype:jira-service-management
891
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttypegroup-get
892
+ */
893
+ getRequestTypeGroups: ({ serviceDeskId, start, limit, }: {
894
+ /**
895
+ * The ID of the service desk whose customer request type groups are to be
896
+ * returned. This can alternatively be a [project
897
+ * identifier.](#project-identifiers)
898
+ */
899
+ serviceDeskId: string;
900
+ /**
901
+ * The starting index of the returned objects. Base index: 0. See the
902
+ * [Pagination](#pagination) section for more details.
903
+ */
904
+ start?: number | undefined;
905
+ /**
906
+ * The maximum number of items to return per page. Default: 50. See the
907
+ * [Pagination](#pagination) section for more details.
908
+ */
909
+ limit?: number | undefined;
910
+ }) => Promise<PagedDtoRequestTypeGroupDto>;
911
+ /**
912
+ * This method returns all customer request types from a service desk. There are
913
+ * two parameters for filtering the returned list:
914
+ *
915
+ * * `groupId` which filters the results to items in the customer request type
916
+ * group.
917
+ * * `searchQuery` which is matched against request types' `name` or
918
+ * `description`. For example, the strings "Install", "Inst", "Equi", or
919
+ * "Equipment" will match a request type with the *name* "Equipment Installation
920
+ * Request".
921
+ *
922
+ * **Note:** This API by default will filter out hidden request types (aka.request
923
+ * types without groups) when `searchQuery` is provided, unless
924
+ * `includeHiddenRequestTypesInSearch` is set to true.
925
+ *
926
+ * **[Permissions](#permissions) required**: Permission to access the service desk.
927
+ *
928
+ * @returns Returns the requested customer request types, on the specified page of the
929
+ * results.
930
+ *
931
+ * example: {
932
+ * "_expands": [],
933
+ * "size": 3,
934
+ * "start": 3,
935
+ * "limit": 3,
936
+ * "isLastPage": false,
937
+ * "_links": {
938
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
939
+ * "context": "context",
940
+ * "next":
941
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=6&limit=3",
942
+ * "prev":
943
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype?start=0&limit=3"
944
+ * },
945
+ * "values": [
946
+ * {
947
+ * "_expands": [],
948
+ * "id": "11001",
949
+ * "_links": {
950
+ * "self":
951
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11001"
952
+ * },
953
+ * "name": "Get IT Help",
954
+ * "description": "Get IT Help",
955
+ * "helpText": "Please tell us clearly the problem you have within 100
956
+ * words.",
957
+ * "issueTypeId": "12345",
958
+ * "serviceDeskId": "28",
959
+ * "portalId": "2",
960
+ * "groupIds": [
961
+ * "12"
962
+ * ],
963
+ * "icon": {
964
+ * "id": "12345",
965
+ * "_links": {
966
+ * "iconUrls": {
967
+ * "48x48":
968
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=large",
969
+ * "24x24":
970
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=small",
971
+ * "16x16":
972
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=xsmall",
973
+ * "32x32":
974
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12345?size=medium"
975
+ * }
976
+ * }
977
+ * }
978
+ * },
979
+ * {
980
+ * "_expands": [],
981
+ * "id": "11002",
982
+ * "_links": {
983
+ * "self":
984
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11002"
985
+ * },
986
+ * "name": "Request a new account",
987
+ * "description": "Request a new account",
988
+ * "issueTypeId": "12345",
989
+ * "serviceDeskId": "28",
990
+ * "portalId": "2",
991
+ * "groupIds": [
992
+ * "13",
993
+ * "14"
994
+ * ],
995
+ * "icon": {
996
+ * "id": "12346",
997
+ * "_links": {
998
+ * "iconUrls": {
999
+ * "48x48":
1000
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12346?size=large",
1001
+ * "24x24":
1002
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12346?size=small",
1003
+ * "16x16":
1004
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12346?size=xsmall",
1005
+ * "32x32":
1006
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12346?size=medium"
1007
+ * }
1008
+ * }
1009
+ * }
1010
+ * },
1011
+ * {
1012
+ * "_expands": [],
1013
+ * "id": "11003",
1014
+ * "_links": {
1015
+ * "self":
1016
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/28/requesttype/11003"
1017
+ * },
1018
+ * "name": "Hardware request",
1019
+ * "description": "Request a hardware support",
1020
+ * "issueTypeId": "12345",
1021
+ * "serviceDeskId": "28",
1022
+ * "portalId": "2",
1023
+ * "groupIds": [
1024
+ * "13"
1025
+ * ],
1026
+ * "icon": {
1027
+ * "id": "12347",
1028
+ * "_links": {
1029
+ * "iconUrls": {
1030
+ * "48x48":
1031
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12347?size=large",
1032
+ * "24x24":
1033
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12347?size=small",
1034
+ * "16x16":
1035
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12347?size=xsmall",
1036
+ * "32x32":
1037
+ * "https://your-domain.atlassian.net/rest/api/2/universal_avatar/view/type/SD_REQTYPE/avatar/12347?size=medium"
1038
+ * }
1039
+ * }
1040
+ * }
1041
+ * }
1042
+ * ]
1043
+ * }
1044
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype
1045
+ * @scopes-current read:servicedesk-request
1046
+ * @scopes-beta read:requesttype:jira-service-management
1047
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-get
1048
+ */
1049
+ getRequestTypes: ({ serviceDeskId, groupId, expand, searchQuery, start, limit, includeHiddenRequestTypesInSearch, }: {
1050
+ /**
1051
+ * The ID of the service desk whose customer request types are to be returned.
1052
+ * This can alternatively be a [project identifier.](#project-identifiers)
1053
+ */
1054
+ serviceDeskId: string;
1055
+ /** Filters results to those in a customer request type group. */
1056
+ groupId?: number | undefined;
1057
+ expand?: string[] | undefined;
1058
+ /** The string to be used to filter the results. */
1059
+ searchQuery?: string | undefined;
1060
+ /**
1061
+ * The starting index of the returned objects. Base index: 0. See the
1062
+ * [Pagination](#pagination) section for more details.
1063
+ */
1064
+ start?: number | undefined;
1065
+ /**
1066
+ * The maximum number of items to return per page. Default: 50. See the
1067
+ * [Pagination](#pagination) section for more details.
1068
+ */
1069
+ limit?: number | undefined;
1070
+ /**
1071
+ * Whether to include hidden request types when searching with `searchQuery`.
1072
+ * Default: false
1073
+ */
1074
+ includeHiddenRequestTypesInSearch?: boolean | undefined;
1075
+ }) => Promise<PagedDtoRequestTypeDto>;
1076
+ /**
1077
+ * This method returns a service desk. Use this method to get service desk details
1078
+ * whenever your application component is passed a service desk ID but needs to
1079
+ * display other service desk details.
1080
+ *
1081
+ * **[Permissions](#permissions) required**: Permission to access the Service
1082
+ * Desk. For example, being the Service Desk's Administrator or one of its Agents
1083
+ * or Users.
1084
+ *
1085
+ * @returns Returns the requested service desk.
1086
+ *
1087
+ * example: {
1088
+ * "id": "10001",
1089
+ * "projectId": "11001",
1090
+ * "projectName": "IT Help Desk",
1091
+ * "projectKey": "ITH",
1092
+ * "_links": {
1093
+ * "self":
1094
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001"
1095
+ * }
1096
+ * }
1097
+ * @path {GET} /rest/servicedeskapi/servicedesk/{serviceDeskId}
1098
+ * @scopes-current read:servicedesk-request
1099
+ * @scopes-beta read:servicedesk:jira-service-management
1100
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-get
1101
+ */
1102
+ getServiceDeskById: ({ serviceDeskId, }: {
1103
+ /**
1104
+ * The ID of the service desk to return. This can alternatively be a [project
1105
+ * identifier.](#project-identifiers)
1106
+ */
1107
+ serviceDeskId: string;
1108
+ }) => Promise<ServiceDeskDto>;
1109
+ /**
1110
+ * This method returns all the service desks in the Jira Service Management
1111
+ * instance that the user has permission to access. Use this method where you need
1112
+ * a list of service desks or need to locate a service desk by name or keyword.
1113
+ *
1114
+ * **Note:** This method will be slow if the instance has hundreds of service
1115
+ * desks. If you want to fetch a single service desk by its ID, use
1116
+ * [/rest/servicedeskapi/servicedesk/\{serviceDeskId\}](./#api-rest-servicedeskapi-servicedesk-servicedeskid-get)
1117
+ * instead.
1118
+ *
1119
+ * **[Permissions](#permissions) required**: Any
1120
+ *
1121
+ * @returns Returns the service desks, on the specified page of the results.
1122
+ *
1123
+ * example: {
1124
+ * "_expands": [],
1125
+ * "size": 3,
1126
+ * "start": 3,
1127
+ * "limit": 3,
1128
+ * "isLastPage": false,
1129
+ * "_links": {
1130
+ * "base": "https://your-domain.atlassian.net/rest/servicedeskapi",
1131
+ * "context": "context",
1132
+ * "next":
1133
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk?start=6&limit=3",
1134
+ * "prev":
1135
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk?start=0&limit=3"
1136
+ * },
1137
+ * "values": [
1138
+ * {
1139
+ * "id": "10001",
1140
+ * "projectId": "11001",
1141
+ * "projectName": "IT Help Desk",
1142
+ * "projectKey": "ITH",
1143
+ * "_links": {
1144
+ * "self":
1145
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10001"
1146
+ * }
1147
+ * },
1148
+ * {
1149
+ * "id": "10002",
1150
+ * "projectId": "11002",
1151
+ * "projectName": "HR Self Serve Desk",
1152
+ * "projectKey": "HR",
1153
+ * "_links": {
1154
+ * "self":
1155
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10002"
1156
+ * }
1157
+ * },
1158
+ * {
1159
+ * "id": "10003",
1160
+ * "projectId": "11003",
1161
+ * "projectName": "Foundation Leave",
1162
+ * "projectKey": "FL",
1163
+ * "_links": {
1164
+ * "self":
1165
+ * "https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/10003"
1166
+ * }
1167
+ * }
1168
+ * ]
1169
+ * }
1170
+ * @path {GET} /rest/servicedeskapi/servicedesk
1171
+ * @scopes-current read:servicedesk-request
1172
+ * @scopes-beta read:servicedesk:jira-service-management
1173
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-get
1174
+ */
1175
+ getServiceDesks: ({ start, limit, }?: {
1176
+ /**
1177
+ * The starting index of the returned objects. Base index: 0. See the
1178
+ * [Pagination](#pagination) section for more details.
1179
+ */
1180
+ start?: number | undefined;
1181
+ /**
1182
+ * The maximum number of items to return per page. Default: 50. See the
1183
+ * [Pagination](#pagination) section for more details.
1184
+ */
1185
+ limit?: number | undefined;
1186
+ }) => Promise<PagedDtoServiceDeskDto>;
1187
+ /**
1188
+ * This method removes one or more customers from a service desk. The service desk
1189
+ * must have closed access. If any of the passed customers are not associated with
1190
+ * the service desk, no changes will be made for those customers and the resource
1191
+ * returns a 204 success code.
1192
+ *
1193
+ * **[Permissions](#permissions) required**: Services desk administrator
1194
+ *
1195
+ * @path {DELETE} /rest/servicedeskapi/servicedesk/{serviceDeskId}/customer
1196
+ * @scopes-current manage:servicedesk-customer
1197
+ * @scopes-beta read:servicedesk.customer:jira-service-management,
1198
+ * delete:servicedesk.customer:jira-service-management
1199
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-customer-delete
1200
+ */
1201
+ removeCustomers: ({ serviceDeskId, serviceDeskCustomerDto, }: {
1202
+ /**
1203
+ * The ID of the service desk the customers should be removed from. This can
1204
+ * alternatively be a [project identifier.](#project-identifiers)
1205
+ */
1206
+ serviceDeskId: string;
1207
+ /**
1208
+ * @example {
1209
+ * "accountIds": [
1210
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
1211
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd",
1212
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"
1213
+ * ],
1214
+ * "usernames": [
1215
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3581db05e2a66fa80b",
1216
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d3a01db05e2a66fa80bd",
1217
+ * "qm:a713c8ea-1075-4e30-9d96-891a7d181739:5ad6d69abfa3980ce712caae"
1218
+ * ]
1219
+ * }
1220
+ */
1221
+ serviceDeskCustomerDto: ServiceDeskCustomerDto;
1222
+ }) => Promise<void>;
1223
+ /**
1224
+ * Sets the value of a request type property. Use this resource to store custom
1225
+ * data against a request type.
1226
+ *
1227
+ * Properties for a Request Type in next-gen are stored as Issue Type properties
1228
+ * and therefore can also be set by calling the Jira Cloud Platform [Set issue
1229
+ * type
1230
+ * property](https://developer.atlassian.com/cloud/jira/platform/rest/v3/#api-rest-api-3-issuetype-issueTypeId-properties-propertyKey-put)
1231
+ * endpoint.
1232
+ *
1233
+ * **[Permissions](#permissions) required**: Jira project administrator with a
1234
+ * Jira Service Management agent license.
1235
+ *
1236
+ * @returns * status: 200, mediaType: application/json
1237
+ *
1238
+ * Returned if the request type property is updated.
1239
+ *
1240
+ * * status: 201, mediaType: application/json
1241
+ *
1242
+ * Returned if the request type property is created.
1243
+ * @path {PUT}
1244
+ * /rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/property/{propertyKey}
1245
+ * @scopes-current manage:jira-project
1246
+ * @scopes-beta read:requesttype.property:jira-service-management,
1247
+ * write:requesttype.property:jira-service-management
1248
+ * @see https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-property-propertykey-put
1249
+ */
1250
+ setProperty: ({ serviceDeskId, requestTypeId, propertyKey, }: {
1251
+ /**
1252
+ * The ID of the service desk which contains the request type. This can
1253
+ * alternatively be a [project identifier.](#project-identifiers)
1254
+ */
1255
+ serviceDeskId: string;
1256
+ /** The ID of the request type on which the property will be set. */
1257
+ requestTypeId: number;
1258
+ /**
1259
+ * The key of the request type property. The maximum length of the key is 255
1260
+ * bytes.
1261
+ */
1262
+ propertyKey: string;
1263
+ }) => Promise<{
1264
+ created: boolean;
1265
+ body: unknown;
1266
+ }>;
1267
+ static initialize(): void;
1268
+ }