@useshortcut/client 1.1.0 → 2.0.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.
@@ -0,0 +1,1415 @@
1
+ import * as axios from 'axios';
2
+ import { Category, CreateCategory, UpdateCategory, Milestone, CustomField, UpdateCustomField, EntityTemplate, CreateEntityTemplate, UpdateEntityTemplate, EpicWorkflow, EpicSlim, CreateEpic, Epic, EpicPaginatedResults, UpdateEpic, ThreadedComment, CreateEpicComment, CreateCommentComment, UpdateComment, Health, CreateEpicHealth, StorySlim, UploadedFile, UpdateFile, Group, CreateGroup, UpdateGroup, UpdateHealth, CreateGenericIntegration, IterationSlim, CreateIteration, Iteration, UpdateIteration, KeyResult, UpdateKeyResult, Label, CreateLabelParams, UpdateLabel, LinkedFile, CreateLinkedFile, UpdateLinkedFile, MemberInfo, Member, CreateMilestone, UpdateMilestone, Objective, CreateObjective, UpdateObjective, Project, CreateProject, UpdateProject, Repository, SearchResults, EpicSearchResults, IterationSearchResults, ObjectiveSearchResults, StorySearchResults, CreateStoryParams, Story, CreateStories, UpdateStories, DeleteStories, CreateStoryFromTemplateParams, SearchStories, UpdateStory, StoryComment, CreateStoryComment, UpdateStoryComment, CreateOrDeleteStoryReaction, StoryReaction, History, CreateTask, Task, UpdateTask, CreateStoryLink, StoryLink, UpdateStoryLink, Workflow } from './data-contracts.mjs';
3
+ import { HttpClient, RequestParams } from './http-client.mjs';
4
+
5
+ /**
6
+ * Please don't use this class directly, instead use the `ShortcutClient` class we provided which is extending this class to add headers for authorization. * @internal
7
+ * @private
8
+ */
9
+ declare class Api<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {
10
+ /**
11
+ * @description List Categories returns a list of all Categories and their attributes.
12
+ *
13
+ * @name ListCategories
14
+ * @summary List Categories
15
+ * @request GET:/api/v3/categories
16
+ * @secure
17
+ */
18
+ listCategories: (params?: RequestParams) => Promise<axios.AxiosResponse<Category[], any>>;
19
+ /**
20
+ * @description Create Category allows you to create a new Category in Shortcut.
21
+ *
22
+ * @name CreateCategory
23
+ * @summary Create Category
24
+ * @request POST:/api/v3/categories
25
+ * @secure
26
+ */
27
+ createCategory: (CreateCategory: CreateCategory, params?: RequestParams) => Promise<axios.AxiosResponse<Category, any>>;
28
+ /**
29
+ * @description Get Category returns information about the selected Category.
30
+ *
31
+ * @name GetCategory
32
+ * @summary Get Category
33
+ * @request GET:/api/v3/categories/{category-public-id}
34
+ * @secure
35
+ */
36
+ getCategory: (categoryPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Category, any>>;
37
+ /**
38
+ * @description Update Category allows you to replace a Category name with another name. If you try to name a Category something that already exists, you will receive a 422 response.
39
+ *
40
+ * @name UpdateCategory
41
+ * @summary Update Category
42
+ * @request PUT:/api/v3/categories/{category-public-id}
43
+ * @secure
44
+ */
45
+ updateCategory: (categoryPublicId: number, UpdateCategory: UpdateCategory, params?: RequestParams) => Promise<axios.AxiosResponse<Category, any>>;
46
+ /**
47
+ * @description Delete Category can be used to delete any Category.
48
+ *
49
+ * @name DeleteCategory
50
+ * @summary Delete Category
51
+ * @request DELETE:/api/v3/categories/{category-public-id}
52
+ * @secure
53
+ */
54
+ deleteCategory: (categoryPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
55
+ /**
56
+ * @description List Category Milestones returns a list of all Milestones with the Category.
57
+ *
58
+ * @name ListCategoryMilestones
59
+ * @summary List Category Milestones
60
+ * @request GET:/api/v3/categories/{category-public-id}/milestones
61
+ * @secure
62
+ */
63
+ listCategoryMilestones: (categoryPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Milestone[], any>>;
64
+ /**
65
+ * @description Returns a list of all Objectives with the Category.
66
+ *
67
+ * @name ListCategoryObjectives
68
+ * @summary List Category Objectives
69
+ * @request GET:/api/v3/categories/{category-public-id}/objectives
70
+ * @secure
71
+ */
72
+ listCategoryObjectives: (categoryPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Milestone[], any>>;
73
+ /**
74
+ * No description
75
+ *
76
+ * @name ListCustomFields
77
+ * @summary List Custom Fields
78
+ * @request GET:/api/v3/custom-fields
79
+ * @secure
80
+ */
81
+ listCustomFields: (params?: RequestParams) => Promise<axios.AxiosResponse<CustomField[], any>>;
82
+ /**
83
+ * No description
84
+ *
85
+ * @name GetCustomField
86
+ * @summary Get Custom Field
87
+ * @request GET:/api/v3/custom-fields/{custom-field-public-id}
88
+ * @secure
89
+ */
90
+ getCustomField: (customFieldPublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<CustomField, any>>;
91
+ /**
92
+ * @description Update Custom Field can be used to update the definition of a Custom Field. The order of items in the 'values' collection is interpreted to be their ascending sort order.To delete an existing enum value, simply omit it from the 'values' collection. New enum values may be created inline by including an object in the 'values' collection having a 'value' entry with no 'id' (eg. {'value': 'myNewValue', 'color_key': 'green'}).
93
+ *
94
+ * @name UpdateCustomField
95
+ * @summary Update Custom Field
96
+ * @request PUT:/api/v3/custom-fields/{custom-field-public-id}
97
+ * @secure
98
+ */
99
+ updateCustomField: (customFieldPublicId: string, UpdateCustomField: UpdateCustomField, params?: RequestParams) => Promise<axios.AxiosResponse<CustomField, any>>;
100
+ /**
101
+ * No description
102
+ *
103
+ * @name DeleteCustomField
104
+ * @summary Delete Custom Field
105
+ * @request DELETE:/api/v3/custom-fields/{custom-field-public-id}
106
+ * @secure
107
+ */
108
+ deleteCustomField: (customFieldPublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
109
+ /**
110
+ * @description List all the entity templates for the Workspace.
111
+ *
112
+ * @name ListEntityTemplates
113
+ * @summary List Entity Templates
114
+ * @request GET:/api/v3/entity-templates
115
+ * @secure
116
+ */
117
+ listEntityTemplates: (params?: RequestParams) => Promise<axios.AxiosResponse<EntityTemplate[], any>>;
118
+ /**
119
+ * @description Create a new entity template for the Workspace.
120
+ *
121
+ * @name CreateEntityTemplate
122
+ * @summary Create Entity Template
123
+ * @request POST:/api/v3/entity-templates
124
+ * @secure
125
+ */
126
+ createEntityTemplate: (CreateEntityTemplate: CreateEntityTemplate, params?: RequestParams) => Promise<axios.AxiosResponse<EntityTemplate, any>>;
127
+ /**
128
+ * @description Disables the Story Template feature for the Workspace.
129
+ *
130
+ * @name DisableStoryTemplates
131
+ * @summary Disable Story Templates
132
+ * @request PUT:/api/v3/entity-templates/disable
133
+ * @secure
134
+ */
135
+ disableStoryTemplates: (params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
136
+ /**
137
+ * @description Enables the Story Template feature for the Workspace.
138
+ *
139
+ * @name EnableStoryTemplates
140
+ * @summary Enable Story Templates
141
+ * @request PUT:/api/v3/entity-templates/enable
142
+ * @secure
143
+ */
144
+ enableStoryTemplates: (params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
145
+ /**
146
+ * @description Get Entity Template returns information about a given entity template.
147
+ *
148
+ * @name GetEntityTemplate
149
+ * @summary Get Entity Template
150
+ * @request GET:/api/v3/entity-templates/{entity-template-public-id}
151
+ * @secure
152
+ */
153
+ getEntityTemplate: (entityTemplatePublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<EntityTemplate, any>>;
154
+ /**
155
+ * @description Update an entity template's name or its contents.
156
+ *
157
+ * @name UpdateEntityTemplate
158
+ * @summary Update Entity Template
159
+ * @request PUT:/api/v3/entity-templates/{entity-template-public-id}
160
+ * @secure
161
+ */
162
+ updateEntityTemplate: (entityTemplatePublicId: string, UpdateEntityTemplate: UpdateEntityTemplate, params?: RequestParams) => Promise<axios.AxiosResponse<EntityTemplate, any>>;
163
+ /**
164
+ * No description
165
+ *
166
+ * @name DeleteEntityTemplate
167
+ * @summary Delete Entity Template
168
+ * @request DELETE:/api/v3/entity-templates/{entity-template-public-id}
169
+ * @secure
170
+ */
171
+ deleteEntityTemplate: (entityTemplatePublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
172
+ /**
173
+ * @description Returns the Epic Workflow for the Workspace.
174
+ *
175
+ * @name GetEpicWorkflow
176
+ * @summary Get Epic Workflow
177
+ * @request GET:/api/v3/epic-workflow
178
+ * @secure
179
+ */
180
+ getEpicWorkflow: (params?: RequestParams) => Promise<axios.AxiosResponse<EpicWorkflow, any>>;
181
+ /**
182
+ * @description List Epics returns a list of all Epics and their attributes.
183
+ *
184
+ * @name ListEpics
185
+ * @summary List Epics
186
+ * @request GET:/api/v3/epics
187
+ * @secure
188
+ */
189
+ listEpics: (query?: {
190
+ /** A true/false boolean indicating whether to return Epics with their descriptions. */
191
+ includes_description?: boolean;
192
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<EpicSlim[], any>>;
193
+ /**
194
+ * @description Create Epic allows you to create a new Epic in Shortcut.
195
+ *
196
+ * @name CreateEpic
197
+ * @summary Create Epic
198
+ * @request POST:/api/v3/epics
199
+ * @secure
200
+ */
201
+ createEpic: (CreateEpic: CreateEpic, params?: RequestParams) => Promise<axios.AxiosResponse<Epic, any>>;
202
+ /**
203
+ * @description List Epics with pagination returns a paginated list of Epics and their attributes.
204
+ *
205
+ * @name ListEpicsPaginated
206
+ * @summary List Epics Paginated
207
+ * @request GET:/api/v3/epics/paginated
208
+ * @secure
209
+ */
210
+ listEpicsPaginated: (query?: {
211
+ /** A true/false boolean indicating whether to return Epics with their descriptions. */
212
+ includes_description?: boolean;
213
+ /**
214
+ * The page number to return, starting with 1. Defaults to 1.
215
+ * @format int64
216
+ */
217
+ page?: number;
218
+ /**
219
+ * The number of Epics to return per page. Minimum 1, maximum 250, default 10.
220
+ * @format int64
221
+ */
222
+ page_size?: number;
223
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<EpicPaginatedResults, any>>;
224
+ /**
225
+ * @description Get Epic returns information about the selected Epic.
226
+ *
227
+ * @name GetEpic
228
+ * @summary Get Epic
229
+ * @request GET:/api/v3/epics/{epic-public-id}
230
+ * @secure
231
+ */
232
+ getEpic: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Epic, any>>;
233
+ /**
234
+ * @description Update Epic can be used to update numerous fields in the Epic. The only required parameter is Epic ID, which can be found in the Shortcut UI.
235
+ *
236
+ * @name UpdateEpic
237
+ * @summary Update Epic
238
+ * @request PUT:/api/v3/epics/{epic-public-id}
239
+ * @secure
240
+ */
241
+ updateEpic: (epicPublicId: number, UpdateEpic: UpdateEpic, params?: RequestParams) => Promise<axios.AxiosResponse<Epic, any>>;
242
+ /**
243
+ * @description Delete Epic can be used to delete the Epic. The only required parameter is Epic ID.
244
+ *
245
+ * @name DeleteEpic
246
+ * @summary Delete Epic
247
+ * @request DELETE:/api/v3/epics/{epic-public-id}
248
+ * @secure
249
+ */
250
+ deleteEpic: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
251
+ /**
252
+ * @description Get a list of all Comments on an Epic.
253
+ *
254
+ * @name ListEpicComments
255
+ * @summary List Epic Comments
256
+ * @request GET:/api/v3/epics/{epic-public-id}/comments
257
+ * @secure
258
+ */
259
+ listEpicComments: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<ThreadedComment[], any>>;
260
+ /**
261
+ * @description This endpoint allows you to create a threaded Comment on an Epic.
262
+ *
263
+ * @name CreateEpicComment
264
+ * @summary Create Epic Comment
265
+ * @request POST:/api/v3/epics/{epic-public-id}/comments
266
+ * @secure
267
+ */
268
+ createEpicComment: (epicPublicId: number, CreateEpicComment: CreateEpicComment, params?: RequestParams) => Promise<axios.AxiosResponse<ThreadedComment, any>>;
269
+ /**
270
+ * @description This endpoint allows you to create a nested Comment reply to an existing Epic Comment.
271
+ *
272
+ * @name CreateEpicCommentComment
273
+ * @summary Create Epic Comment Comment
274
+ * @request POST:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
275
+ * @secure
276
+ */
277
+ createEpicCommentComment: (epicPublicId: number, commentPublicId: number, CreateCommentComment: CreateCommentComment, params?: RequestParams) => Promise<axios.AxiosResponse<ThreadedComment, any>>;
278
+ /**
279
+ * @description This endpoint returns information about the selected Epic Comment.
280
+ *
281
+ * @name GetEpicComment
282
+ * @summary Get Epic Comment
283
+ * @request GET:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
284
+ * @secure
285
+ */
286
+ getEpicComment: (epicPublicId: number, commentPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<ThreadedComment, any>>;
287
+ /**
288
+ * @description This endpoint allows you to update a threaded Comment on an Epic.
289
+ *
290
+ * @name UpdateEpicComment
291
+ * @summary Update Epic Comment
292
+ * @request PUT:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
293
+ * @secure
294
+ */
295
+ updateEpicComment: (epicPublicId: number, commentPublicId: number, UpdateComment: UpdateComment, params?: RequestParams) => Promise<axios.AxiosResponse<ThreadedComment, any>>;
296
+ /**
297
+ * @description This endpoint allows you to delete a Comment from an Epic.
298
+ *
299
+ * @name DeleteEpicComment
300
+ * @summary Delete Epic Comment
301
+ * @request DELETE:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
302
+ * @secure
303
+ */
304
+ deleteEpicComment: (epicPublicId: number, commentPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
305
+ /**
306
+ * @description Get the current health for the specified Epic.
307
+ *
308
+ * @name GetEpicHealth
309
+ * @summary Get Epic Health
310
+ * @request GET:/api/v3/epics/{epic-public-id}/health
311
+ * @secure
312
+ */
313
+ getEpicHealth: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Health, any>>;
314
+ /**
315
+ * @description Create a new health status for the specified Epic.
316
+ *
317
+ * @name CreateEpicHealth
318
+ * @summary Create Epic Health
319
+ * @request POST:/api/v3/epics/{epic-public-id}/health
320
+ * @secure
321
+ */
322
+ createEpicHealth: (epicPublicId: number, CreateEpicHealth: CreateEpicHealth, params?: RequestParams) => Promise<axios.AxiosResponse<Health, any>>;
323
+ /**
324
+ * @description List the history of health statuses for the specified Epic, most recent first.
325
+ *
326
+ * @name ListEpicHealths
327
+ * @summary List Epic Healths
328
+ * @request GET:/api/v3/epics/{epic-public-id}/health-history
329
+ * @secure
330
+ */
331
+ listEpicHealths: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Health[], any>>;
332
+ /**
333
+ * @description Get a list of all Stories in an Epic.
334
+ *
335
+ * @name ListEpicStories
336
+ * @summary List Epic Stories
337
+ * @request GET:/api/v3/epics/{epic-public-id}/stories
338
+ * @secure
339
+ */
340
+ listEpicStories: (epicPublicId: number, query?: {
341
+ /** A true/false boolean indicating whether to return Stories with their descriptions. */
342
+ includes_description?: boolean;
343
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
344
+ /**
345
+ * @description This endpoint allows you to unlink a productboard epic.
346
+ *
347
+ * @name UnlinkProductboardFromEpic
348
+ * @summary Unlink Productboard from Epic
349
+ * @request POST:/api/v3/epics/{epic-public-id}/unlink-productboard
350
+ * @secure
351
+ */
352
+ unlinkProductboardFromEpic: (epicPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
353
+ /**
354
+ * @description Get Stories which have a given External Link associated with them.
355
+ *
356
+ * @name GetExternalLinkStories
357
+ * @summary Get External Link Stories
358
+ * @request GET:/api/v3/external-link/stories
359
+ * @secure
360
+ */
361
+ getExternalLinkStories: (query: {
362
+ /**
363
+ * The external link associated with one or more stories.
364
+ * @maxLength 2048
365
+ * @pattern ^https?://.+$
366
+ */
367
+ external_link: string;
368
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
369
+ /**
370
+ * @description List Files returns a list of all UploadedFiles in the workspace.
371
+ *
372
+ * @name ListFiles
373
+ * @summary List Files
374
+ * @request GET:/api/v3/files
375
+ * @secure
376
+ */
377
+ listFiles: (params?: RequestParams) => Promise<axios.AxiosResponse<UploadedFile[], any>>;
378
+ /**
379
+ * @description Upload Files uploads one or many files and optionally associates them with a story. Use the multipart/form-data content-type to upload. Each `file` key should contain a separate file. Each UploadedFile's name comes from the Content-Disposition header "filename" directive for that field.
380
+ *
381
+ * @name UploadFiles
382
+ * @summary Upload Files
383
+ * @request POST:/api/v3/files
384
+ * @secure
385
+ */
386
+ uploadFiles: (data: {
387
+ /**
388
+ * The story ID that these files will be associated with.
389
+ * @format int64
390
+ */
391
+ story_id?: number;
392
+ /**
393
+ * A file upload. At least one is required.
394
+ * @format binary
395
+ */
396
+ file0: File;
397
+ /**
398
+ * Optional additional files.
399
+ * @format binary
400
+ */
401
+ file1?: File;
402
+ /**
403
+ * Optional additional files.
404
+ * @format binary
405
+ */
406
+ file2?: File;
407
+ /**
408
+ * Optional additional files.
409
+ * @format binary
410
+ */
411
+ file3?: File;
412
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<UploadedFile[], any>>;
413
+ /**
414
+ * @description Get File returns information about the selected UploadedFile.
415
+ *
416
+ * @name GetFile
417
+ * @summary Get File
418
+ * @request GET:/api/v3/files/{file-public-id}
419
+ * @secure
420
+ */
421
+ getFile: (filePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<UploadedFile, any>>;
422
+ /**
423
+ * @description Update File updates the properties of an UploadedFile (but not its content).
424
+ *
425
+ * @name UpdateFile
426
+ * @summary Update File
427
+ * @request PUT:/api/v3/files/{file-public-id}
428
+ * @secure
429
+ */
430
+ updateFile: (filePublicId: number, UpdateFile: UpdateFile, params?: RequestParams) => Promise<axios.AxiosResponse<UploadedFile, any>>;
431
+ /**
432
+ * @description Delete File deletes a previously uploaded file.
433
+ *
434
+ * @name DeleteFile
435
+ * @summary Delete File
436
+ * @request DELETE:/api/v3/files/{file-public-id}
437
+ * @secure
438
+ */
439
+ deleteFile: (filePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
440
+ /**
441
+ * @description A group in our API maps to a "Team" within the Shortcut Product. A Team is a collection of Users that can be associated to Stories, Epics, and Iterations within Shortcut.
442
+ *
443
+ * @name ListGroups
444
+ * @summary List Groups
445
+ * @request GET:/api/v3/groups
446
+ * @secure
447
+ */
448
+ listGroups: (params?: RequestParams) => Promise<axios.AxiosResponse<Group[], any>>;
449
+ /**
450
+ * No description
451
+ *
452
+ * @name CreateGroup
453
+ * @summary Create Group
454
+ * @request POST:/api/v3/groups
455
+ * @secure
456
+ */
457
+ createGroup: (CreateGroup: CreateGroup, params?: RequestParams) => Promise<axios.AxiosResponse<Group, any>>;
458
+ /**
459
+ * No description
460
+ *
461
+ * @name GetGroup
462
+ * @summary Get Group
463
+ * @request GET:/api/v3/groups/{group-public-id}
464
+ * @secure
465
+ */
466
+ getGroup: (groupPublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<Group, any>>;
467
+ /**
468
+ * No description
469
+ *
470
+ * @name UpdateGroup
471
+ * @summary Update Group
472
+ * @request PUT:/api/v3/groups/{group-public-id}
473
+ * @secure
474
+ */
475
+ updateGroup: (groupPublicId: string, UpdateGroup: UpdateGroup, params?: RequestParams) => Promise<axios.AxiosResponse<Group, any>>;
476
+ /**
477
+ * @description List the Stories assigned to the Group. (By default, limited to 1,000).
478
+ *
479
+ * @name ListGroupStories
480
+ * @summary List Group Stories
481
+ * @request GET:/api/v3/groups/{group-public-id}/stories
482
+ * @secure
483
+ */
484
+ listGroupStories: (groupPublicId: string, query?: {
485
+ /**
486
+ * The maximum number of results to return. (Defaults to 1000, max 1000)
487
+ * @format int64
488
+ */
489
+ limit?: number;
490
+ /**
491
+ * The offset at which to begin returning results. (Defaults to 0)
492
+ * @format int64
493
+ */
494
+ offset?: number;
495
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
496
+ /**
497
+ * @description Update an existing health status by its ID.
498
+ *
499
+ * @name UpdateHealth
500
+ * @summary Update Health
501
+ * @request PUT:/api/v3/health/{health-public-id}
502
+ * @secure
503
+ */
504
+ updateHealth: (healthPublicId: string, UpdateHealth: UpdateHealth, params?: RequestParams) => Promise<axios.AxiosResponse<Health, any>>;
505
+ /**
506
+ * No description
507
+ *
508
+ * @name CreateGenericIntegration
509
+ * @summary Create Generic Integration
510
+ * @request POST:/api/v3/integrations/webhook
511
+ * @secure
512
+ */
513
+ createGenericIntegration: (CreateGenericIntegration: CreateGenericIntegration, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
514
+ /**
515
+ * No description
516
+ *
517
+ * @name GetGenericIntegration
518
+ * @summary Get Generic Integration
519
+ * @request GET:/api/v3/integrations/webhook/{integration-public-id}
520
+ * @secure
521
+ */
522
+ getGenericIntegration: (integrationPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
523
+ /**
524
+ * No description
525
+ *
526
+ * @name DeleteGenericIntegration
527
+ * @summary Delete Generic Integration
528
+ * @request DELETE:/api/v3/integrations/webhook/{integration-public-id}
529
+ * @secure
530
+ */
531
+ deleteGenericIntegration: (integrationPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
532
+ /**
533
+ * No description
534
+ *
535
+ * @name ListIterations
536
+ * @summary List Iterations
537
+ * @request GET:/api/v3/iterations
538
+ * @secure
539
+ */
540
+ listIterations: (params?: RequestParams) => Promise<axios.AxiosResponse<IterationSlim[], any>>;
541
+ /**
542
+ * No description
543
+ *
544
+ * @name CreateIteration
545
+ * @summary Create Iteration
546
+ * @request POST:/api/v3/iterations
547
+ * @secure
548
+ */
549
+ createIteration: (CreateIteration: CreateIteration, params?: RequestParams) => Promise<axios.AxiosResponse<Iteration, any>>;
550
+ /**
551
+ * @description Disables Iterations for the current workspace
552
+ *
553
+ * @name DisableIterations
554
+ * @summary Disable Iterations
555
+ * @request PUT:/api/v3/iterations/disable
556
+ * @secure
557
+ */
558
+ disableIterations: (params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
559
+ /**
560
+ * @description Enables Iterations for the current workspace
561
+ *
562
+ * @name EnableIterations
563
+ * @summary Enable Iterations
564
+ * @request PUT:/api/v3/iterations/enable
565
+ * @secure
566
+ */
567
+ enableIterations: (params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
568
+ /**
569
+ * No description
570
+ *
571
+ * @name GetIteration
572
+ * @summary Get Iteration
573
+ * @request GET:/api/v3/iterations/{iteration-public-id}
574
+ * @secure
575
+ */
576
+ getIteration: (iterationPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Iteration, any>>;
577
+ /**
578
+ * No description
579
+ *
580
+ * @name UpdateIteration
581
+ * @summary Update Iteration
582
+ * @request PUT:/api/v3/iterations/{iteration-public-id}
583
+ * @secure
584
+ */
585
+ updateIteration: (iterationPublicId: number, UpdateIteration: UpdateIteration, params?: RequestParams) => Promise<axios.AxiosResponse<Iteration, any>>;
586
+ /**
587
+ * No description
588
+ *
589
+ * @name DeleteIteration
590
+ * @summary Delete Iteration
591
+ * @request DELETE:/api/v3/iterations/{iteration-public-id}
592
+ * @secure
593
+ */
594
+ deleteIteration: (iterationPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
595
+ /**
596
+ * @description Get a list of all Stories in an Iteration.
597
+ *
598
+ * @name ListIterationStories
599
+ * @summary List Iteration Stories
600
+ * @request GET:/api/v3/iterations/{iteration-public-id}/stories
601
+ * @secure
602
+ */
603
+ listIterationStories: (iterationPublicId: number, query?: {
604
+ /** A true/false boolean indicating whether to return Stories with their descriptions. */
605
+ includes_description?: boolean;
606
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
607
+ /**
608
+ * @description Get Key Result returns information about a chosen Key Result.
609
+ *
610
+ * @name GetKeyResult
611
+ * @summary Get Key Result
612
+ * @request GET:/api/v3/key-results/{key-result-public-id}
613
+ * @secure
614
+ */
615
+ getKeyResult: (keyResultPublicId: string, params?: RequestParams) => Promise<axios.AxiosResponse<KeyResult, any>>;
616
+ /**
617
+ * @description Update Key Result allows updating a Key Result's name or initial, observed, or target values.
618
+ *
619
+ * @name UpdateKeyResult
620
+ * @summary Update Key Result
621
+ * @request PUT:/api/v3/key-results/{key-result-public-id}
622
+ * @secure
623
+ */
624
+ updateKeyResult: (keyResultPublicId: string, UpdateKeyResult: UpdateKeyResult, params?: RequestParams) => Promise<axios.AxiosResponse<KeyResult, any>>;
625
+ /**
626
+ * @description List Labels returns a list of all Labels and their attributes.
627
+ *
628
+ * @name ListLabels
629
+ * @summary List Labels
630
+ * @request GET:/api/v3/labels
631
+ * @secure
632
+ */
633
+ listLabels: (query?: {
634
+ /** A true/false boolean indicating if the slim versions of the Label should be returned. */
635
+ slim?: boolean;
636
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<Label[], any>>;
637
+ /**
638
+ * @description Create Label allows you to create a new Label in Shortcut.
639
+ *
640
+ * @name CreateLabel
641
+ * @summary Create Label
642
+ * @request POST:/api/v3/labels
643
+ * @secure
644
+ */
645
+ createLabel: (CreateLabelParams: CreateLabelParams, params?: RequestParams) => Promise<axios.AxiosResponse<Label, any>>;
646
+ /**
647
+ * @description Get Label returns information about the selected Label.
648
+ *
649
+ * @name GetLabel
650
+ * @summary Get Label
651
+ * @request GET:/api/v3/labels/{label-public-id}
652
+ * @secure
653
+ */
654
+ getLabel: (labelPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Label, any>>;
655
+ /**
656
+ * @description Update Label allows you to replace a Label name with another name. If you try to name a Label something that already exists, you will receive a 422 response.
657
+ *
658
+ * @name UpdateLabel
659
+ * @summary Update Label
660
+ * @request PUT:/api/v3/labels/{label-public-id}
661
+ * @secure
662
+ */
663
+ updateLabel: (labelPublicId: number, UpdateLabel: UpdateLabel, params?: RequestParams) => Promise<axios.AxiosResponse<Label, any>>;
664
+ /**
665
+ * @description Delete Label can be used to delete any Label.
666
+ *
667
+ * @name DeleteLabel
668
+ * @summary Delete Label
669
+ * @request DELETE:/api/v3/labels/{label-public-id}
670
+ * @secure
671
+ */
672
+ deleteLabel: (labelPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
673
+ /**
674
+ * @description List all of the Epics with the Label.
675
+ *
676
+ * @name ListLabelEpics
677
+ * @summary List Label Epics
678
+ * @request GET:/api/v3/labels/{label-public-id}/epics
679
+ * @secure
680
+ */
681
+ listLabelEpics: (labelPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<EpicSlim[], any>>;
682
+ /**
683
+ * @description List all of the Stories with the Label.
684
+ *
685
+ * @name ListLabelStories
686
+ * @summary List Label Stories
687
+ * @request GET:/api/v3/labels/{label-public-id}/stories
688
+ * @secure
689
+ */
690
+ listLabelStories: (labelPublicId: number, query?: {
691
+ /** A true/false boolean indicating whether to return Stories with their descriptions. */
692
+ includes_description?: boolean;
693
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
694
+ /**
695
+ * @description List Linked Files returns a list of all Linked-Files and their attributes.
696
+ *
697
+ * @name ListLinkedFiles
698
+ * @summary List Linked Files
699
+ * @request GET:/api/v3/linked-files
700
+ * @secure
701
+ */
702
+ listLinkedFiles: (params?: RequestParams) => Promise<axios.AxiosResponse<LinkedFile[], any>>;
703
+ /**
704
+ * @description Create Linked File allows you to create a new Linked File in Shortcut.
705
+ *
706
+ * @name CreateLinkedFile
707
+ * @summary Create Linked File
708
+ * @request POST:/api/v3/linked-files
709
+ * @secure
710
+ */
711
+ createLinkedFile: (CreateLinkedFile: CreateLinkedFile, params?: RequestParams) => Promise<axios.AxiosResponse<LinkedFile, any>>;
712
+ /**
713
+ * @description Get File returns information about the selected Linked File.
714
+ *
715
+ * @name GetLinkedFile
716
+ * @summary Get Linked File
717
+ * @request GET:/api/v3/linked-files/{linked-file-public-id}
718
+ * @secure
719
+ */
720
+ getLinkedFile: (linkedFilePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<LinkedFile, any>>;
721
+ /**
722
+ * @description Updated Linked File allows you to update properties of a previously attached Linked-File.
723
+ *
724
+ * @name UpdateLinkedFile
725
+ * @summary Update Linked File
726
+ * @request PUT:/api/v3/linked-files/{linked-file-public-id}
727
+ * @secure
728
+ */
729
+ updateLinkedFile: (linkedFilePublicId: number, UpdateLinkedFile: UpdateLinkedFile, params?: RequestParams) => Promise<axios.AxiosResponse<LinkedFile, any>>;
730
+ /**
731
+ * @description Delete Linked File can be used to delete any previously attached Linked-File.
732
+ *
733
+ * @name DeleteLinkedFile
734
+ * @summary Delete Linked File
735
+ * @request DELETE:/api/v3/linked-files/{linked-file-public-id}
736
+ * @secure
737
+ */
738
+ deleteLinkedFile: (linkedFilePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
739
+ /**
740
+ * @description Returns information about the authenticated member.
741
+ *
742
+ * @name GetCurrentMemberInfo
743
+ * @summary Get Current Member Info
744
+ * @request GET:/api/v3/member
745
+ * @secure
746
+ */
747
+ getCurrentMemberInfo: (params?: RequestParams) => Promise<axios.AxiosResponse<MemberInfo, any>>;
748
+ /**
749
+ * @description Returns information about members of the Workspace.
750
+ *
751
+ * @name ListMembers
752
+ * @summary List Members
753
+ * @request GET:/api/v3/members
754
+ * @secure
755
+ */
756
+ listMembers: (query?: {
757
+ /**
758
+ * The unique ID of the Organization to limit the list to.
759
+ * @format uuid
760
+ */
761
+ "org-public-id"?: string;
762
+ /** Filter members by their disabled state. If true, return only disabled members. If false, return only enabled members. */
763
+ disabled?: boolean;
764
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<Member[], any>>;
765
+ /**
766
+ * @description Returns information about a Member.
767
+ *
768
+ * @name GetMember
769
+ * @summary Get Member
770
+ * @request GET:/api/v3/members/{member-public-id}
771
+ * @secure
772
+ */
773
+ getMember: (memberPublicId: string, query?: {
774
+ /**
775
+ * The unique ID of the Organization to limit the lookup to.
776
+ * @format uuid
777
+ */
778
+ "org-public-id"?: string;
779
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<Member, any>>;
780
+ /**
781
+ * @description (Deprecated: Use 'List Objectives') List Milestones returns a list of all Milestones and their attributes.
782
+ *
783
+ * @name ListMilestones
784
+ * @summary List Milestones
785
+ * @request GET:/api/v3/milestones
786
+ * @secure
787
+ */
788
+ listMilestones: (params?: RequestParams) => Promise<axios.AxiosResponse<Milestone[], any>>;
789
+ /**
790
+ * @description (Deprecated: Use 'Create Objective') Create Milestone allows you to create a new Milestone in Shortcut.
791
+ *
792
+ * @name CreateMilestone
793
+ * @summary Create Milestone
794
+ * @request POST:/api/v3/milestones
795
+ * @secure
796
+ */
797
+ createMilestone: (CreateMilestone: CreateMilestone, params?: RequestParams) => Promise<axios.AxiosResponse<Milestone, any>>;
798
+ /**
799
+ * @description (Deprecated: Use 'Get Objective') Get Milestone returns information about a chosen Milestone.
800
+ *
801
+ * @name GetMilestone
802
+ * @summary Get Milestone
803
+ * @request GET:/api/v3/milestones/{milestone-public-id}
804
+ * @secure
805
+ */
806
+ getMilestone: (milestonePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Milestone, any>>;
807
+ /**
808
+ * @description (Deprecated: Use 'Update Objective') Update Milestone can be used to update Milestone properties.
809
+ *
810
+ * @name UpdateMilestone
811
+ * @summary Update Milestone
812
+ * @request PUT:/api/v3/milestones/{milestone-public-id}
813
+ * @secure
814
+ */
815
+ updateMilestone: (milestonePublicId: number, UpdateMilestone: UpdateMilestone, params?: RequestParams) => Promise<axios.AxiosResponse<Milestone, any>>;
816
+ /**
817
+ * @description (Deprecated: Use 'Delete Objective') Delete Milestone can be used to delete any Milestone.
818
+ *
819
+ * @name DeleteMilestone
820
+ * @summary Delete Milestone
821
+ * @request DELETE:/api/v3/milestones/{milestone-public-id}
822
+ * @secure
823
+ */
824
+ deleteMilestone: (milestonePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
825
+ /**
826
+ * @description (Deprecated: Use 'List Objective Epics') List all of the Epics within the Milestone.
827
+ *
828
+ * @name ListMilestoneEpics
829
+ * @summary List Milestone Epics
830
+ * @request GET:/api/v3/milestones/{milestone-public-id}/epics
831
+ * @secure
832
+ */
833
+ listMilestoneEpics: (milestonePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<EpicSlim[], any>>;
834
+ /**
835
+ * @description List Objectives returns a list of all Objectives and their attributes.
836
+ *
837
+ * @name ListObjectives
838
+ * @summary List Objectives
839
+ * @request GET:/api/v3/objectives
840
+ * @secure
841
+ */
842
+ listObjectives: (params?: RequestParams) => Promise<axios.AxiosResponse<Objective[], any>>;
843
+ /**
844
+ * @description Create Objective allows you to create a new Objective in Shortcut.
845
+ *
846
+ * @name CreateObjective
847
+ * @summary Create Objective
848
+ * @request POST:/api/v3/objectives
849
+ * @secure
850
+ */
851
+ createObjective: (CreateObjective: CreateObjective, params?: RequestParams) => Promise<axios.AxiosResponse<Objective, any>>;
852
+ /**
853
+ * @description Get Objective returns information about a chosen Objective.
854
+ *
855
+ * @name GetObjective
856
+ * @summary Get Objective
857
+ * @request GET:/api/v3/objectives/{objective-public-id}
858
+ * @secure
859
+ */
860
+ getObjective: (objectivePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Objective, any>>;
861
+ /**
862
+ * @description Update Objective can be used to update Objective properties.
863
+ *
864
+ * @name UpdateObjective
865
+ * @summary Update Objective
866
+ * @request PUT:/api/v3/objectives/{objective-public-id}
867
+ * @secure
868
+ */
869
+ updateObjective: (objectivePublicId: number, UpdateObjective: UpdateObjective, params?: RequestParams) => Promise<axios.AxiosResponse<Objective, any>>;
870
+ /**
871
+ * @description Delete Objective can be used to delete any Objective.
872
+ *
873
+ * @name DeleteObjective
874
+ * @summary Delete Objective
875
+ * @request DELETE:/api/v3/objectives/{objective-public-id}
876
+ * @secure
877
+ */
878
+ deleteObjective: (objectivePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
879
+ /**
880
+ * @description List all of the Epics within the Objective.
881
+ *
882
+ * @name ListObjectiveEpics
883
+ * @summary List Objective Epics
884
+ * @request GET:/api/v3/objectives/{objective-public-id}/epics
885
+ * @secure
886
+ */
887
+ listObjectiveEpics: (objectivePublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<EpicSlim[], any>>;
888
+ /**
889
+ * @description List Projects returns a list of all Projects and their attributes.
890
+ *
891
+ * @name ListProjects
892
+ * @summary List Projects
893
+ * @request GET:/api/v3/projects
894
+ * @secure
895
+ */
896
+ listProjects: (params?: RequestParams) => Promise<axios.AxiosResponse<Project[], any>>;
897
+ /**
898
+ * @description Create Project is used to create a new Shortcut Project.
899
+ *
900
+ * @name CreateProject
901
+ * @summary Create Project
902
+ * @request POST:/api/v3/projects
903
+ * @secure
904
+ */
905
+ createProject: (CreateProject: CreateProject, params?: RequestParams) => Promise<axios.AxiosResponse<Project, any>>;
906
+ /**
907
+ * @description Get Project returns information about the selected Project.
908
+ *
909
+ * @name GetProject
910
+ * @summary Get Project
911
+ * @request GET:/api/v3/projects/{project-public-id}
912
+ * @secure
913
+ */
914
+ getProject: (projectPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Project, any>>;
915
+ /**
916
+ * @description Update Project can be used to change properties of a Project.
917
+ *
918
+ * @name UpdateProject
919
+ * @summary Update Project
920
+ * @request PUT:/api/v3/projects/{project-public-id}
921
+ * @secure
922
+ */
923
+ updateProject: (projectPublicId: number, UpdateProject: UpdateProject, params?: RequestParams) => Promise<axios.AxiosResponse<Project, any>>;
924
+ /**
925
+ * @description Delete Project can be used to delete a Project. Projects can only be deleted if all associated Stories are moved or deleted. In the case that the Project cannot be deleted, you will receive a 422 response.
926
+ *
927
+ * @name DeleteProject
928
+ * @summary Delete Project
929
+ * @request DELETE:/api/v3/projects/{project-public-id}
930
+ * @secure
931
+ */
932
+ deleteProject: (projectPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
933
+ /**
934
+ * @description List Stories returns a list of all Stories in a selected Project and their attributes.
935
+ *
936
+ * @name ListStories
937
+ * @summary List Stories
938
+ * @request GET:/api/v3/projects/{project-public-id}/stories
939
+ * @secure
940
+ */
941
+ listStories: (projectPublicId: number, query?: {
942
+ /** A true/false boolean indicating whether to return Stories with their descriptions. */
943
+ includes_description?: boolean;
944
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
945
+ /**
946
+ * @description List Repositories returns a list of all Repositories and their attributes.
947
+ *
948
+ * @name ListRepositories
949
+ * @summary List Repositories
950
+ * @request GET:/api/v3/repositories
951
+ * @secure
952
+ */
953
+ listRepositories: (params?: RequestParams) => Promise<axios.AxiosResponse<Repository[], any>>;
954
+ /**
955
+ * @description Get Repository returns information about the selected Repository.
956
+ *
957
+ * @name GetRepository
958
+ * @summary Get Repository
959
+ * @request GET:/api/v3/repositories/{repo-public-id}
960
+ * @secure
961
+ */
962
+ getRepository: (repoPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Repository, any>>;
963
+ /**
964
+ * @description Search lets you search Epics and Stories based on desired parameters. Since ordering of the results can change over time (due to search ranking decay, new Epics and Stories being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
965
+ *
966
+ * @name Search
967
+ * @summary Search
968
+ * @request GET:/api/v3/search
969
+ * @secure
970
+ */
971
+ search: (query: {
972
+ /**
973
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
974
+ * @minLength 1
975
+ */
976
+ query: string;
977
+ /**
978
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
979
+ * @format int64
980
+ */
981
+ page_size?: number;
982
+ /**
983
+ * The amount of detail included in each result item.
984
+ * "full" will include all descriptions and comments and more fields on
985
+ * related items such as pull requests, branches and tasks.
986
+ * "slim" omits larger fulltext fields such as descriptions and comments
987
+ * and only references related items by id.
988
+ * The default is "full".
989
+ */
990
+ detail?: "full" | "slim";
991
+ /** The next page token. */
992
+ next?: string;
993
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
994
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
995
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<SearchResults, any>>;
996
+ /**
997
+ * @description Search Epics lets you search Epics based on desired parameters. Since ordering of stories can change over time (due to search ranking decay, new Epics being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
998
+ *
999
+ * @name SearchEpics
1000
+ * @summary Search Epics
1001
+ * @request GET:/api/v3/search/epics
1002
+ * @secure
1003
+ */
1004
+ searchEpics: (query: {
1005
+ /**
1006
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
1007
+ * @minLength 1
1008
+ */
1009
+ query: string;
1010
+ /**
1011
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
1012
+ * @format int64
1013
+ */
1014
+ page_size?: number;
1015
+ /**
1016
+ * The amount of detail included in each result item.
1017
+ * "full" will include all descriptions and comments and more fields on
1018
+ * related items such as pull requests, branches and tasks.
1019
+ * "slim" omits larger fulltext fields such as descriptions and comments
1020
+ * and only references related items by id.
1021
+ * The default is "full".
1022
+ */
1023
+ detail?: "full" | "slim";
1024
+ /** The next page token. */
1025
+ next?: string;
1026
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
1027
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
1028
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<EpicSearchResults, any>>;
1029
+ /**
1030
+ * @description Search Iterations lets you search Iterations based on desired parameters. Since ordering of results can change over time (due to search ranking decay, new Iterations being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
1031
+ *
1032
+ * @name SearchIterations
1033
+ * @summary Search Iterations
1034
+ * @request GET:/api/v3/search/iterations
1035
+ * @secure
1036
+ */
1037
+ searchIterations: (query: {
1038
+ /**
1039
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
1040
+ * @minLength 1
1041
+ */
1042
+ query: string;
1043
+ /**
1044
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
1045
+ * @format int64
1046
+ */
1047
+ page_size?: number;
1048
+ /**
1049
+ * The amount of detail included in each result item.
1050
+ * "full" will include all descriptions and comments and more fields on
1051
+ * related items such as pull requests, branches and tasks.
1052
+ * "slim" omits larger fulltext fields such as descriptions and comments
1053
+ * and only references related items by id.
1054
+ * The default is "full".
1055
+ */
1056
+ detail?: "full" | "slim";
1057
+ /** The next page token. */
1058
+ next?: string;
1059
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
1060
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
1061
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<IterationSearchResults, any>>;
1062
+ /**
1063
+ * @description Search Milestones lets you search Milestones based on desired parameters. Since ordering of results can change over time (due to search ranking decay, new Milestones being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
1064
+ *
1065
+ * @name SearchMilestones
1066
+ * @summary Search Milestones
1067
+ * @request GET:/api/v3/search/milestones
1068
+ * @secure
1069
+ */
1070
+ searchMilestones: (query: {
1071
+ /**
1072
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
1073
+ * @minLength 1
1074
+ */
1075
+ query: string;
1076
+ /**
1077
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
1078
+ * @format int64
1079
+ */
1080
+ page_size?: number;
1081
+ /**
1082
+ * The amount of detail included in each result item.
1083
+ * "full" will include all descriptions and comments and more fields on
1084
+ * related items such as pull requests, branches and tasks.
1085
+ * "slim" omits larger fulltext fields such as descriptions and comments
1086
+ * and only references related items by id.
1087
+ * The default is "full".
1088
+ */
1089
+ detail?: "full" | "slim";
1090
+ /** The next page token. */
1091
+ next?: string;
1092
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
1093
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
1094
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<ObjectiveSearchResults, any>>;
1095
+ /**
1096
+ * @description Search Objectives lets you search Objectives based on desired parameters. Since ordering of results can change over time (due to search ranking decay, new Objectives being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
1097
+ *
1098
+ * @name SearchObjectives
1099
+ * @summary Search Objectives
1100
+ * @request GET:/api/v3/search/objectives
1101
+ * @secure
1102
+ */
1103
+ searchObjectives: (query: {
1104
+ /**
1105
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
1106
+ * @minLength 1
1107
+ */
1108
+ query: string;
1109
+ /**
1110
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
1111
+ * @format int64
1112
+ */
1113
+ page_size?: number;
1114
+ /**
1115
+ * The amount of detail included in each result item.
1116
+ * "full" will include all descriptions and comments and more fields on
1117
+ * related items such as pull requests, branches and tasks.
1118
+ * "slim" omits larger fulltext fields such as descriptions and comments
1119
+ * and only references related items by id.
1120
+ * The default is "full".
1121
+ */
1122
+ detail?: "full" | "slim";
1123
+ /** The next page token. */
1124
+ next?: string;
1125
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
1126
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
1127
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<ObjectiveSearchResults, any>>;
1128
+ /**
1129
+ * @description Search Stories lets you search Stories based on desired parameters. Since ordering of stories can change over time (due to search ranking decay, new stories being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.
1130
+ *
1131
+ * @name SearchStories
1132
+ * @summary Search Stories
1133
+ * @request GET:/api/v3/search/stories
1134
+ * @secure
1135
+ */
1136
+ searchStories: (query: {
1137
+ /**
1138
+ * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
1139
+ * @minLength 1
1140
+ */
1141
+ query: string;
1142
+ /**
1143
+ * The number of search results to include in a page. Minimum of 1 and maximum of 250.
1144
+ * @format int64
1145
+ */
1146
+ page_size?: number;
1147
+ /**
1148
+ * The amount of detail included in each result item.
1149
+ * "full" will include all descriptions and comments and more fields on
1150
+ * related items such as pull requests, branches and tasks.
1151
+ * "slim" omits larger fulltext fields such as descriptions and comments
1152
+ * and only references related items by id.
1153
+ * The default is "full".
1154
+ */
1155
+ detail?: "full" | "slim";
1156
+ /** The next page token. */
1157
+ next?: string;
1158
+ /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story. */
1159
+ entity_types?: ("story" | "milestone" | "epic" | "iteration" | "objective")[];
1160
+ }, params?: RequestParams) => Promise<axios.AxiosResponse<StorySearchResults, any>>;
1161
+ /**
1162
+ * @description Create Story is used to add a new story to your Shortcut Workspace. This endpoint requires that either **workflow_state_id** or **project_id** be provided, but will reject the request if both or neither are specified. The workflow_state_id has been marked as required and is the recommended field to specify because we are in the process of sunsetting Projects in Shortcut.
1163
+ *
1164
+ * @name CreateStory
1165
+ * @summary Create Story
1166
+ * @request POST:/api/v3/stories
1167
+ * @secure
1168
+ */
1169
+ createStory: (CreateStoryParams: CreateStoryParams, params?: RequestParams) => Promise<axios.AxiosResponse<Story, any>>;
1170
+ /**
1171
+ * @description Create Multiple Stories allows you to create multiple stories in a single request using the same syntax as [Create Story](https://developer.shortcut.com/api/rest/v3#create-story).
1172
+ *
1173
+ * @name CreateMultipleStories
1174
+ * @summary Create Multiple Stories
1175
+ * @request POST:/api/v3/stories/bulk
1176
+ * @secure
1177
+ */
1178
+ createMultipleStories: (CreateStories: CreateStories, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
1179
+ /**
1180
+ * @description Update Multiple Stories allows you to make changes to numerous stories at once.
1181
+ *
1182
+ * @name UpdateMultipleStories
1183
+ * @summary Update Multiple Stories
1184
+ * @request PUT:/api/v3/stories/bulk
1185
+ * @secure
1186
+ */
1187
+ updateMultipleStories: (UpdateStories: UpdateStories, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
1188
+ /**
1189
+ * @description Delete Multiple Stories allows you to delete multiple archived stories at once.
1190
+ *
1191
+ * @name DeleteMultipleStories
1192
+ * @summary Delete Multiple Stories
1193
+ * @request DELETE:/api/v3/stories/bulk
1194
+ * @secure
1195
+ */
1196
+ deleteMultipleStories: (DeleteStories: DeleteStories, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1197
+ /**
1198
+ * @description Create Story From Template is used to add a new story derived from a template to your Shortcut Workspace.
1199
+ *
1200
+ * @name CreateStoryFromTemplate
1201
+ * @summary Create Story From Template
1202
+ * @request POST:/api/v3/stories/from-template
1203
+ * @secure
1204
+ */
1205
+ createStoryFromTemplate: (CreateStoryFromTemplateParams: CreateStoryFromTemplateParams, params?: RequestParams) => Promise<axios.AxiosResponse<Story, any>>;
1206
+ /**
1207
+ * @description Search Stories lets you search Stories based on desired parameters.
1208
+ *
1209
+ * @name SearchStoriesOld
1210
+ * @summary Search Stories (Old)
1211
+ * @request POST:/api/v3/stories/search
1212
+ * @secure
1213
+ */
1214
+ searchStoriesOld: (SearchStories: SearchStories, params?: RequestParams) => Promise<axios.AxiosResponse<StorySlim[], any>>;
1215
+ /**
1216
+ * @description Get Story returns information about a chosen Story.
1217
+ *
1218
+ * @name GetStory
1219
+ * @summary Get Story
1220
+ * @request GET:/api/v3/stories/{story-public-id}
1221
+ * @secure
1222
+ */
1223
+ getStory: (storyPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Story, any>>;
1224
+ /**
1225
+ * @description Update Story can be used to update Story properties.
1226
+ *
1227
+ * @name UpdateStory
1228
+ * @summary Update Story
1229
+ * @request PUT:/api/v3/stories/{story-public-id}
1230
+ * @secure
1231
+ */
1232
+ updateStory: (storyPublicId: number, UpdateStory: UpdateStory, params?: RequestParams) => Promise<axios.AxiosResponse<Story, any>>;
1233
+ /**
1234
+ * @description Delete Story can be used to delete any Story.
1235
+ *
1236
+ * @name DeleteStory
1237
+ * @summary Delete Story
1238
+ * @request DELETE:/api/v3/stories/{story-public-id}
1239
+ * @secure
1240
+ */
1241
+ deleteStory: (storyPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1242
+ /**
1243
+ * @description Lists Comments associated with a Story
1244
+ *
1245
+ * @name ListStoryComment
1246
+ * @summary List Story Comment
1247
+ * @request GET:/api/v3/stories/{story-public-id}/comments
1248
+ * @secure
1249
+ */
1250
+ listStoryComment: (storyPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<StoryComment[], any>>;
1251
+ /**
1252
+ * @description Create Comment allows you to create a Comment on any Story.
1253
+ *
1254
+ * @name CreateStoryComment
1255
+ * @summary Create Story Comment
1256
+ * @request POST:/api/v3/stories/{story-public-id}/comments
1257
+ * @secure
1258
+ */
1259
+ createStoryComment: (storyPublicId: number, CreateStoryComment: CreateStoryComment, params?: RequestParams) => Promise<axios.AxiosResponse<StoryComment, any>>;
1260
+ /**
1261
+ * @description Get Comment is used to get Comment information.
1262
+ *
1263
+ * @name GetStoryComment
1264
+ * @summary Get Story Comment
1265
+ * @request GET:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
1266
+ * @secure
1267
+ */
1268
+ getStoryComment: (storyPublicId: number, commentPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<StoryComment, any>>;
1269
+ /**
1270
+ * @description Update Comment replaces the text of the existing Comment.
1271
+ *
1272
+ * @name UpdateStoryComment
1273
+ * @summary Update Story Comment
1274
+ * @request PUT:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
1275
+ * @secure
1276
+ */
1277
+ updateStoryComment: (storyPublicId: number, commentPublicId: number, UpdateStoryComment: UpdateStoryComment, params?: RequestParams) => Promise<axios.AxiosResponse<StoryComment, any>>;
1278
+ /**
1279
+ * @description Delete a Comment from any story.
1280
+ *
1281
+ * @name DeleteStoryComment
1282
+ * @summary Delete Story Comment
1283
+ * @request DELETE:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
1284
+ * @secure
1285
+ */
1286
+ deleteStoryComment: (storyPublicId: number, commentPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1287
+ /**
1288
+ * @description Create a reaction to a story comment.
1289
+ *
1290
+ * @name CreateStoryReaction
1291
+ * @summary Create Story Reaction
1292
+ * @request POST:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/reactions
1293
+ * @secure
1294
+ */
1295
+ createStoryReaction: (storyPublicId: number, commentPublicId: number, CreateOrDeleteStoryReaction: CreateOrDeleteStoryReaction, params?: RequestParams) => Promise<axios.AxiosResponse<StoryReaction[], any>>;
1296
+ /**
1297
+ * @description Delete a reaction from any story comment.
1298
+ *
1299
+ * @name DeleteStoryReaction
1300
+ * @summary Delete Story Reaction
1301
+ * @request DELETE:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/reactions
1302
+ * @secure
1303
+ */
1304
+ deleteStoryReaction: (storyPublicId: number, commentPublicId: number, CreateOrDeleteStoryReaction: CreateOrDeleteStoryReaction, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1305
+ /**
1306
+ * @description Unlinks a Comment from its linked Slack thread (Comment replies and Slack replies will no longer be synced)
1307
+ *
1308
+ * @name UnlinkCommentThreadFromSlack
1309
+ * @summary Unlink Comment thread from Slack
1310
+ * @request POST:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/unlink-from-slack
1311
+ * @secure
1312
+ */
1313
+ unlinkCommentThreadFromSlack: (storyPublicId: number, commentPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<StoryComment, any>>;
1314
+ /**
1315
+ * No description
1316
+ *
1317
+ * @name StoryHistory
1318
+ * @summary Story History
1319
+ * @request GET:/api/v3/stories/{story-public-id}/history
1320
+ * @secure
1321
+ */
1322
+ storyHistory: (storyPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<History[], any>>;
1323
+ /**
1324
+ * @description Create Task is used to create a new task in a Story.
1325
+ *
1326
+ * @name CreateTask
1327
+ * @summary Create Task
1328
+ * @request POST:/api/v3/stories/{story-public-id}/tasks
1329
+ * @secure
1330
+ */
1331
+ createTask: (storyPublicId: number, CreateTask: CreateTask, params?: RequestParams) => Promise<axios.AxiosResponse<Task, any>>;
1332
+ /**
1333
+ * @description Returns information about a chosen Task.
1334
+ *
1335
+ * @name GetTask
1336
+ * @summary Get Task
1337
+ * @request GET:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
1338
+ * @secure
1339
+ */
1340
+ getTask: (storyPublicId: number, taskPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Task, any>>;
1341
+ /**
1342
+ * @description Update Task can be used to update Task properties.
1343
+ *
1344
+ * @name UpdateTask
1345
+ * @summary Update Task
1346
+ * @request PUT:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
1347
+ * @secure
1348
+ */
1349
+ updateTask: (storyPublicId: number, taskPublicId: number, UpdateTask: UpdateTask, params?: RequestParams) => Promise<axios.AxiosResponse<Task, any>>;
1350
+ /**
1351
+ * @description Delete Task can be used to delete any previously created Task on a Story.
1352
+ *
1353
+ * @name DeleteTask
1354
+ * @summary Delete Task
1355
+ * @request DELETE:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
1356
+ * @secure
1357
+ */
1358
+ deleteTask: (storyPublicId: number, taskPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1359
+ /**
1360
+ * @description Story Links (called Story Relationships in the UI) allow you create semantic relationships between two stories. The parameters read like an active voice grammatical sentence: subject -> verb -> object. The subject story acts on the object Story; the object story is the direct object of the sentence. The subject story "blocks", "duplicates", or "relates to" the object story. Examples: - "story 5 blocks story 6” -- story 6 is now "blocked" until story 5 is moved to a Done workflow state. - "story 2 duplicates story 1” -- Story 2 represents the same body of work as Story 1 (and should probably be archived). - "story 7 relates to story 3”
1361
+ *
1362
+ * @name CreateStoryLink
1363
+ * @summary Create Story Link
1364
+ * @request POST:/api/v3/story-links
1365
+ * @secure
1366
+ */
1367
+ createStoryLink: (CreateStoryLink: CreateStoryLink, params?: RequestParams) => Promise<axios.AxiosResponse<StoryLink, any>>;
1368
+ /**
1369
+ * @description Returns the stories and their relationship for the given Story Link.
1370
+ *
1371
+ * @name GetStoryLink
1372
+ * @summary Get Story Link
1373
+ * @request GET:/api/v3/story-links/{story-link-public-id}
1374
+ * @secure
1375
+ */
1376
+ getStoryLink: (storyLinkPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<StoryLink, any>>;
1377
+ /**
1378
+ * @description Updates the stories and/or the relationship for the given Story Link.
1379
+ *
1380
+ * @name UpdateStoryLink
1381
+ * @summary Update Story Link
1382
+ * @request PUT:/api/v3/story-links/{story-link-public-id}
1383
+ * @secure
1384
+ */
1385
+ updateStoryLink: (storyLinkPublicId: number, UpdateStoryLink: UpdateStoryLink, params?: RequestParams) => Promise<axios.AxiosResponse<StoryLink, any>>;
1386
+ /**
1387
+ * @description Removes the relationship between the stories for the given Story Link.
1388
+ *
1389
+ * @name DeleteStoryLink
1390
+ * @summary Delete Story Link
1391
+ * @request DELETE:/api/v3/story-links/{story-link-public-id}
1392
+ * @secure
1393
+ */
1394
+ deleteStoryLink: (storyLinkPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<void, any>>;
1395
+ /**
1396
+ * @description Returns a list of all Workflows in the Workspace.
1397
+ *
1398
+ * @name ListWorkflows
1399
+ * @summary List Workflows
1400
+ * @request GET:/api/v3/workflows
1401
+ * @secure
1402
+ */
1403
+ listWorkflows: (params?: RequestParams) => Promise<axios.AxiosResponse<Workflow[], any>>;
1404
+ /**
1405
+ * @description Get Workflow returns information about a chosen Workflow.
1406
+ *
1407
+ * @name GetWorkflow
1408
+ * @summary Get Workflow
1409
+ * @request GET:/api/v3/workflows/{workflow-public-id}
1410
+ * @secure
1411
+ */
1412
+ getWorkflow: (workflowPublicId: number, params?: RequestParams) => Promise<axios.AxiosResponse<Workflow, any>>;
1413
+ }
1414
+
1415
+ export { Api };