@itentialopensource/adapter-terraform_enterprise 0.2.0 → 0.3.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 (45) hide show
  1. package/AUTH.md +11 -14
  2. package/CALLS.md +575 -22
  3. package/CHANGELOG.md +16 -0
  4. package/CONTRIBUTING.md +1 -160
  5. package/ENHANCE.md +2 -2
  6. package/README.md +32 -23
  7. package/SUMMARY.md +1 -1
  8. package/SYSTEMINFO.md +15 -6
  9. package/adapter.js +157 -329
  10. package/adapterBase.js +549 -879
  11. package/changelogs/CHANGELOG.md +52 -0
  12. package/metadata.json +61 -0
  13. package/package.json +24 -24
  14. package/pronghorn.json +470 -138
  15. package/propertiesSchema.json +431 -31
  16. package/refs?service=git-upload-pack +0 -0
  17. package/report/adapter-openapi.json +3984 -0
  18. package/report/adapter-openapi.yaml +2861 -0
  19. package/report/adapterInfo.json +8 -8
  20. package/report/updateReport1691507498223.json +120 -0
  21. package/report/updateReport1692202520108.json +120 -0
  22. package/report/updateReport1694461356284.json +120 -0
  23. package/report/updateReport1698420765161.json +120 -0
  24. package/sampleProperties.json +63 -2
  25. package/test/integration/adapterTestBasicGet.js +2 -4
  26. package/test/integration/adapterTestConnectivity.js +91 -42
  27. package/test/integration/adapterTestIntegration.js +130 -2
  28. package/test/unit/adapterBaseTestUnit.js +388 -313
  29. package/test/unit/adapterTestUnit.js +338 -112
  30. package/utils/adapterInfo.js +1 -1
  31. package/utils/addAuth.js +1 -1
  32. package/utils/artifactize.js +1 -1
  33. package/utils/checkMigrate.js +1 -1
  34. package/utils/entitiesToDB.js +2 -2
  35. package/utils/findPath.js +1 -1
  36. package/utils/methodDocumentor.js +273 -0
  37. package/utils/modify.js +13 -15
  38. package/utils/packModificationScript.js +1 -1
  39. package/utils/pre-commit.sh +2 -0
  40. package/utils/taskMover.js +309 -0
  41. package/utils/tbScript.js +89 -34
  42. package/utils/tbUtils.js +41 -21
  43. package/utils/testRunner.js +1 -1
  44. package/utils/troubleshootingAdapter.js +9 -6
  45. package/workflows/README.md +0 -3
@@ -0,0 +1,2861 @@
1
+ openapi: 3.0.0
2
+ info:
3
+ title: Terraform
4
+ description: >-
5
+ Terraform Cloud is an application that helps teams use Terraform together. It manages Terraform runs in a consistent and reliable environment, and includes easy access to shared state and secret data, access controls for approving changes to infrastructure, a private registry for sharing Terraform modules, detailed policy controls for governing the contents of Terraform configurations, and more.
6
+
7
+
8
+ Terraform Cloud is available as a hosted service at https://app.terraform.io. We offer free accounts for small teams, and paid plans with additional feature sets for medium-sized businesses.
9
+
10
+
11
+ Large enterprises can purchase Terraform Enterprise, our self-hosted distribution of Terraform Cloud. It offers enterprises a private instance of the Terraform Cloud application, with no resource limits and with additional enterprise-grade architectural features like audit logging and SAML single sign-on.
12
+ contact:
13
+ email: apiteam@swagger.io
14
+ version: 'v2'
15
+ servers:
16
+ - url: https://app.terraform.io/api
17
+ variables: {}
18
+ - url: http://app.terraform.io/api
19
+ variables: {}
20
+ paths:
21
+ /account/details:
22
+ get:
23
+ tags:
24
+ - Account
25
+ summary: GET
26
+ description: Get account details.
27
+ operationId: GET
28
+ parameters: []
29
+ responses:
30
+ '200':
31
+ description: successful operation
32
+ headers: {}
33
+ content:
34
+ text/plain:
35
+ schema:
36
+ type: string
37
+ description: successful operation
38
+ '400':
39
+ description: failed operation
40
+ headers: {}
41
+ content: {}
42
+ deprecated: false
43
+ /account/update:
44
+ patch:
45
+ tags:
46
+ - Account
47
+ summary: updateAccount
48
+ description: Update account details
49
+ operationId: updateAccount
50
+ parameters: []
51
+ requestBody:
52
+ description: JSON body for update
53
+ content:
54
+ text/plain:
55
+ schema:
56
+ type: string
57
+ description: JSON body for update
58
+ required: false
59
+ responses:
60
+ '200':
61
+ description: successful operation
62
+ headers: {}
63
+ content:
64
+ text/plain:
65
+ schema:
66
+ type: string
67
+ description: successful operation
68
+ '400':
69
+ description: failed operation
70
+ headers: {}
71
+ content: {}
72
+ deprecated: false
73
+ /account/password:
74
+ patch:
75
+ tags:
76
+ - Account
77
+ summary: changePassword
78
+ description: Change your password
79
+ operationId: changePassword
80
+ parameters: []
81
+ requestBody:
82
+ description: ''
83
+ content:
84
+ text/plain:
85
+ schema:
86
+ type: string
87
+ required: false
88
+ responses:
89
+ '200':
90
+ description: successful operation
91
+ headers: {}
92
+ content:
93
+ text/plain:
94
+ schema:
95
+ type: string
96
+ description: successful operation
97
+ '400':
98
+ description: failed operation
99
+ headers: {}
100
+ content: {}
101
+ deprecated: false
102
+ /applies/{id}:
103
+ get:
104
+ tags:
105
+ - Applies
106
+ summary: getApply
107
+ description: Show an apply
108
+ operationId: getApply
109
+ parameters:
110
+ - name: id
111
+ in: path
112
+ description: The ID of the apply to show.
113
+ required: true
114
+ style: simple
115
+ schema:
116
+ type: object
117
+ responses:
118
+ '200':
119
+ description: successful operation
120
+ headers: {}
121
+ content:
122
+ text/plain:
123
+ schema:
124
+ type: string
125
+ description: successful operation
126
+ '400':
127
+ description: failed operation
128
+ headers: {}
129
+ content: {}
130
+ deprecated: false
131
+ /cost-estimates/{id}:
132
+ get:
133
+ tags:
134
+ - CostEstimates
135
+ summary: getCostEstimate
136
+ description: Show a cost estimate
137
+ operationId: getCostEstimate
138
+ parameters:
139
+ - name: id
140
+ in: path
141
+ description: The ID of the cost estimate to show..
142
+ required: true
143
+ style: simple
144
+ schema:
145
+ type: object
146
+ responses:
147
+ '200':
148
+ description: successful operation
149
+ headers: {}
150
+ content:
151
+ text/plain:
152
+ schema:
153
+ type: string
154
+ description: successful operation
155
+ '400':
156
+ description: failed operation
157
+ headers: {}
158
+ content: {}
159
+ deprecated: false
160
+ /workspaces/{workspace_id}/notification-configurations:
161
+ post:
162
+ tags:
163
+ - NotificationConfigurations
164
+ summary: createNotificationConfiguration
165
+ description: Create a Notification Configuration
166
+ operationId: createNotificationConfiguration
167
+ parameters:
168
+ - name: workspace_id
169
+ in: path
170
+ description: ''
171
+ required: true
172
+ style: simple
173
+ schema:
174
+ type: string
175
+ requestBody:
176
+ description: ''
177
+ content:
178
+ text/plain:
179
+ schema:
180
+ type: string
181
+ required: false
182
+ responses:
183
+ '200':
184
+ description: successful operation
185
+ headers: {}
186
+ content:
187
+ text/plain:
188
+ schema:
189
+ type: string
190
+ description: successful operation
191
+ '400':
192
+ description: failed operation
193
+ headers: {}
194
+ content: {}
195
+ deprecated: false
196
+ get:
197
+ tags:
198
+ - NotificationConfigurations
199
+ summary: listNotificationConfigurations
200
+ description: List all notification configurations
201
+ operationId: listNotificationConfigurations
202
+ parameters:
203
+ - name: workspace_id
204
+ in: path
205
+ description: The ID of the workspace to list configurations from. Obtain this from the workspace settings or the Show Workspace endpoint.
206
+ required: true
207
+ style: simple
208
+ schema:
209
+ type: string
210
+ responses:
211
+ '200':
212
+ description: successful operation
213
+ headers: {}
214
+ content:
215
+ text/plain:
216
+ schema:
217
+ type: string
218
+ description: successful operation
219
+ '400':
220
+ description: failed operation
221
+ headers: {}
222
+ content: {}
223
+ deprecated: false
224
+ /notification-configurations/{notification-configuration-id}:
225
+ get:
226
+ tags:
227
+ - NotificationConfigurations
228
+ summary: getNotificationConfiguration
229
+ description: Get details for a notification configuration
230
+ operationId: getNotificationConfiguration
231
+ parameters:
232
+ - name: notification-configuration-id
233
+ in: path
234
+ description: The id of the notification configuration to show.
235
+ required: true
236
+ style: simple
237
+ schema:
238
+ type: string
239
+ responses:
240
+ '200':
241
+ description: successful operation
242
+ headers: {}
243
+ content:
244
+ text/plain:
245
+ schema:
246
+ type: string
247
+ description: successful operation
248
+ '400':
249
+ description: failed operation
250
+ headers: {}
251
+ content: {}
252
+ deprecated: false
253
+ patch:
254
+ tags:
255
+ - NotificationConfigurations
256
+ summary: updateNotificationConfiguration
257
+ description: Update a notification configuration
258
+ operationId: updateNotificationConfiguration
259
+ parameters:
260
+ - name: notification-configuration-id
261
+ in: path
262
+ description: The id of the notification configuration to update.
263
+ required: true
264
+ style: simple
265
+ schema:
266
+ type: string
267
+ responses:
268
+ '200':
269
+ description: successful operation
270
+ headers: {}
271
+ content:
272
+ text/plain:
273
+ schema:
274
+ type: string
275
+ description: successful operation
276
+ '400':
277
+ description: failed operation
278
+ headers: {}
279
+ content: {}
280
+ deprecated: false
281
+ delete:
282
+ tags:
283
+ - NotificationConfigurations
284
+ summary: deleteNotificationConfiguration
285
+ description: This endpoint deletes a notification configuration.
286
+ operationId: deleteNotificationConfiguration
287
+ parameters:
288
+ - name: notification-configuration-id
289
+ in: path
290
+ description: The id of the notification configuration to delete.
291
+ required: true
292
+ style: simple
293
+ schema:
294
+ type: string
295
+ responses:
296
+ '200':
297
+ description: successful operation
298
+ headers: {}
299
+ content:
300
+ text/plain:
301
+ schema:
302
+ type: string
303
+ description: successful operation
304
+ '400':
305
+ description: failed operation
306
+ headers: {}
307
+ content: {}
308
+ deprecated: false
309
+ /notification-configurations/{notification-configuration-id}/actions/verify:
310
+ post:
311
+ tags:
312
+ - NotificationConfigurations
313
+ summary: verifyNotificationConfiguration
314
+ description: This will cause Terraform Cloud to send a verification request for the specified configuration. If a response is received, it will be stored and returned in the delivery-responses attribute. More details in the Notification Verification and Delivery Responses section above.
315
+ operationId: verifyNotificationConfiguration
316
+ parameters:
317
+ - name: notification-configuration-id
318
+ in: path
319
+ description: The id of the notification configuration to verify.
320
+ required: true
321
+ style: simple
322
+ schema:
323
+ type: string
324
+ responses:
325
+ '200':
326
+ description: successful operation
327
+ headers: {}
328
+ content:
329
+ text/plain:
330
+ schema:
331
+ type: string
332
+ description: successful operation
333
+ '400':
334
+ description: failed operation
335
+ headers: {}
336
+ content: {}
337
+ deprecated: false
338
+ /organizations/{organization_name}/oauth-clients:
339
+ get:
340
+ tags:
341
+ - OAuthClients
342
+ summary: listOauthClients
343
+ description: This endpoint allows you to list VCS connections between an organization and a VCS provider (GitHub, Bitbucket, or GitLab) for use when creating or setting up workspaces.
344
+ operationId: listOauthClients
345
+ parameters:
346
+ - name: organization_name
347
+ in: path
348
+ description: The name of the organization.
349
+ required: true
350
+ style: simple
351
+ schema:
352
+ type: string
353
+ responses:
354
+ '200':
355
+ description: successful operation
356
+ headers: {}
357
+ content:
358
+ text/plain:
359
+ schema:
360
+ type: string
361
+ description: successful operation
362
+ '400':
363
+ description: failed operation
364
+ headers: {}
365
+ content: {}
366
+ deprecated: false
367
+ post:
368
+ tags:
369
+ - OAuthClients
370
+ summary: createOAuthClient
371
+ description: Create an OAuth Client
372
+ operationId: createOAuthClient
373
+ parameters:
374
+ - name: organization_name
375
+ in: path
376
+ description: The name of the organization that will be connected to the VCS provider. The organization must already exist in the system, and the user must have permissions to initiate the connection.
377
+ required: true
378
+ style: simple
379
+ schema:
380
+ type: string
381
+ requestBody:
382
+ description: ''
383
+ content:
384
+ text/plain:
385
+ schema:
386
+ type: string
387
+ required: false
388
+ responses:
389
+ '200':
390
+ description: successful operation
391
+ headers: {}
392
+ content:
393
+ text/plain:
394
+ schema:
395
+ type: string
396
+ description: successful operation
397
+ '400':
398
+ description: failed operation
399
+ headers: {}
400
+ content: {}
401
+ deprecated: false
402
+ /oauth-clients/{id}:
403
+ get:
404
+ tags:
405
+ - OAuthClients
406
+ summary: showOAuthClient
407
+ description: Show an OAuth Client
408
+ operationId: showOAuthClient
409
+ parameters:
410
+ - name: id
411
+ in: path
412
+ description: The ID of the OAuth Client to show
413
+ required: true
414
+ style: simple
415
+ schema:
416
+ type: string
417
+ responses:
418
+ '200':
419
+ description: successful operation
420
+ headers: {}
421
+ content:
422
+ text/plain:
423
+ schema:
424
+ type: string
425
+ description: successful operation
426
+ '400':
427
+ description: failed operation
428
+ headers: {}
429
+ content: {}
430
+ deprecated: false
431
+ patch:
432
+ tags:
433
+ - OAuthClients
434
+ summary: updateOAuthClient
435
+ description: Update an OAuth Client
436
+ operationId: updateOAuthClient
437
+ parameters:
438
+ - name: id
439
+ in: path
440
+ description: The ID of the OAuth Client to update.
441
+ required: true
442
+ style: simple
443
+ schema:
444
+ type: string
445
+ requestBody:
446
+ description: ''
447
+ content:
448
+ text/plain:
449
+ schema:
450
+ type: string
451
+ required: false
452
+ responses:
453
+ '200':
454
+ description: successful operation
455
+ headers: {}
456
+ content:
457
+ text/plain:
458
+ schema:
459
+ type: string
460
+ description: successful operation
461
+ '400':
462
+ description: failed operation
463
+ headers: {}
464
+ content: {}
465
+ deprecated: false
466
+ delete:
467
+ tags:
468
+ - OAuthClients
469
+ summary: destroyOAuthClient
470
+ description: Destroy an OAuth Client
471
+ operationId: destroyOAuthClient
472
+ parameters:
473
+ - name: id
474
+ in: path
475
+ description: The ID of the OAuth Client to destroy
476
+ required: true
477
+ style: simple
478
+ schema:
479
+ type: string
480
+ responses:
481
+ '200':
482
+ description: successful operation
483
+ headers: {}
484
+ content:
485
+ text/plain:
486
+ schema:
487
+ type: string
488
+ description: successful operation
489
+ '400':
490
+ description: failed operation
491
+ headers: {}
492
+ content: {}
493
+ deprecated: false
494
+ /oauth-clients/{oauth_client_id}/oauth-tokens:
495
+ get:
496
+ tags:
497
+ - OAuthTokens
498
+ summary: listOAuthTokens
499
+ description: List all the OAuth Tokens for a given OAuth Client
500
+ operationId: listOAuthTokens
501
+ parameters:
502
+ - name: oauth_client_id
503
+ in: path
504
+ description: The ID of the OAuth Client
505
+ required: true
506
+ style: simple
507
+ schema:
508
+ type: string
509
+ responses:
510
+ '200':
511
+ description: successful operation
512
+ headers: {}
513
+ content:
514
+ text/plain:
515
+ schema:
516
+ type: string
517
+ description: successful operation
518
+ '400':
519
+ description: failed operation
520
+ headers: {}
521
+ content: {}
522
+ deprecated: false
523
+ /oauth-tokens/{id}:
524
+ get:
525
+ tags:
526
+ - OAuthTokens
527
+ summary: showOAuthToken
528
+ description: Show an OAuth Token
529
+ operationId: showOAuthToken
530
+ parameters:
531
+ - name: id
532
+ in: path
533
+ description: The ID of the OAuth token to show
534
+ required: true
535
+ style: simple
536
+ schema:
537
+ type: string
538
+ responses:
539
+ '200':
540
+ description: successful operation
541
+ headers: {}
542
+ content:
543
+ text/plain:
544
+ schema:
545
+ type: string
546
+ description: successful operation
547
+ '400':
548
+ description: failed operation
549
+ headers: {}
550
+ content: {}
551
+ deprecated: false
552
+ patch:
553
+ tags:
554
+ - OAuthTokens
555
+ summary: updateOAuthToken
556
+ description: Update an OAuth Token
557
+ operationId: updateOAuthToken
558
+ parameters:
559
+ - name: id
560
+ in: path
561
+ description: The ID of the OAuth token to update
562
+ required: true
563
+ style: simple
564
+ schema:
565
+ type: string
566
+ requestBody:
567
+ description: ''
568
+ content:
569
+ text/plain:
570
+ schema:
571
+ type: string
572
+ required: false
573
+ responses:
574
+ '200':
575
+ description: successful operation
576
+ headers: {}
577
+ content:
578
+ text/plain:
579
+ schema:
580
+ type: string
581
+ description: successful operation
582
+ '400':
583
+ description: failed operation
584
+ headers: {}
585
+ content: {}
586
+ deprecated: false
587
+ delete:
588
+ tags:
589
+ - OAuthTokens
590
+ summary: destroyOAuthToken
591
+ description: Destroy an OAuth Token
592
+ operationId: destroyOAuthToken
593
+ parameters:
594
+ - name: id
595
+ in: path
596
+ description: The ID of the OAuth Token to destroy
597
+ required: true
598
+ style: simple
599
+ schema:
600
+ type: string
601
+ responses:
602
+ '200':
603
+ description: successful operation
604
+ headers: {}
605
+ content:
606
+ text/plain:
607
+ schema:
608
+ type: string
609
+ description: successful operation
610
+ '400':
611
+ description: failed operation
612
+ headers: {}
613
+ content: {}
614
+ deprecated: false
615
+ /organizations:
616
+ get:
617
+ tags:
618
+ - Organizations
619
+ summary: listOrganizations
620
+ description: List the organizations
621
+ operationId: listOrganizations
622
+ parameters: []
623
+ responses:
624
+ '200':
625
+ description: successful operation
626
+ headers: {}
627
+ content:
628
+ text/plain:
629
+ schema:
630
+ type: string
631
+ description: successful operation
632
+ '400':
633
+ description: failed operation
634
+ headers: {}
635
+ content: {}
636
+ deprecated: false
637
+ /organizations/{organization_name}:
638
+ get:
639
+ tags:
640
+ - Organizations
641
+ summary: getOrganization
642
+ description: Get an organization
643
+ operationId: getOrganization
644
+ parameters:
645
+ - name: organization_name
646
+ in: path
647
+ description: The name of the organization to show
648
+ required: true
649
+ style: simple
650
+ schema:
651
+ type: string
652
+ responses:
653
+ '200':
654
+ description: successful operation
655
+ headers: {}
656
+ content:
657
+ text/plain:
658
+ schema:
659
+ type: string
660
+ description: successful operation
661
+ '400':
662
+ description: failed operation
663
+ headers: {}
664
+ content: {}
665
+ deprecated: false
666
+ /organizations/{organization_name}/organization-memberships:
667
+ post:
668
+ tags:
669
+ - OrganizationMemberships
670
+ summary: InviteUserToOrganization
671
+ description: Invite a User to an Organization
672
+ operationId: InviteUserToOrganization
673
+ parameters:
674
+ - name: organization_name
675
+ in: path
676
+ description: The name of the organization the user will be invited to join. The inviting user must have permission to manage organization memberships
677
+ required: true
678
+ style: simple
679
+ schema:
680
+ type: string
681
+ requestBody:
682
+ description: ''
683
+ content:
684
+ text/plain:
685
+ schema:
686
+ type: string
687
+ required: false
688
+ responses:
689
+ '200':
690
+ description: successful operation
691
+ headers: {}
692
+ content:
693
+ text/plain:
694
+ schema:
695
+ type: string
696
+ description: successful operation
697
+ '400':
698
+ description: failed operation
699
+ headers: {}
700
+ content: {}
701
+ deprecated: false
702
+ get:
703
+ tags:
704
+ - OrganizationMemberships
705
+ summary: listMembershipsOrganization
706
+ description: List Memberships for an Organization
707
+ operationId: listMembershipsOrganization
708
+ parameters:
709
+ - name: organization_name
710
+ in: path
711
+ description: The name of the organization to list the memberships of.
712
+ required: true
713
+ style: simple
714
+ schema:
715
+ type: string
716
+ - name: q
717
+ in: query
718
+ description: Optional. A search query string. Organization memberships are searchable by user name and email.
719
+ style: form
720
+ explode: true
721
+ schema:
722
+ type: string
723
+ - name: filter[status]
724
+ in: query
725
+ description: Optional. If specified, restricts results to those with the matching status value. Valid values are invited and active.
726
+ style: form
727
+ explode: true
728
+ schema:
729
+ type: string
730
+ - name: page[number]
731
+ in: query
732
+ description: Optional. If omitted, the endpoint will return the first page.
733
+ style: form
734
+ explode: true
735
+ schema:
736
+ type: string
737
+ - name: page[size]
738
+ in: query
739
+ description: Optional. If omitted, the endpoint will return 20 users per page.
740
+ style: form
741
+ explode: true
742
+ schema:
743
+ type: string
744
+ responses:
745
+ '200':
746
+ description: successful operation
747
+ headers: {}
748
+ content:
749
+ text/plain:
750
+ schema:
751
+ type: string
752
+ description: successful operation
753
+ '400':
754
+ description: failed operation
755
+ headers: {}
756
+ content: {}
757
+ deprecated: false
758
+ /organization-memberships:
759
+ get:
760
+ tags:
761
+ - OrganizationMemberships
762
+ summary: listUserOwnMemberships
763
+ description: List User's Own Memberships
764
+ operationId: listUserOwnMemberships
765
+ parameters: []
766
+ responses:
767
+ '200':
768
+ description: successful operation
769
+ headers: {}
770
+ content:
771
+ text/plain:
772
+ schema:
773
+ type: string
774
+ description: successful operation
775
+ '400':
776
+ description: failed operation
777
+ headers: {}
778
+ content: {}
779
+ deprecated: false
780
+ /organization-memberships/{organization_membership_id}:
781
+ get:
782
+ tags:
783
+ - OrganizationMemberships
784
+ summary: showMembership
785
+ description: Show a Membership
786
+ operationId: showMembership
787
+ parameters:
788
+ - name: organization_membership_id
789
+ in: path
790
+ description: The organization membership
791
+ required: true
792
+ style: simple
793
+ schema:
794
+ type: string
795
+ responses:
796
+ '200':
797
+ description: successful operation
798
+ headers: {}
799
+ content:
800
+ text/plain:
801
+ schema:
802
+ type: string
803
+ description: successful operation
804
+ '400':
805
+ description: failed operation
806
+ headers: {}
807
+ content: {}
808
+ deprecated: false
809
+ delete:
810
+ tags:
811
+ - OrganizationMemberships
812
+ summary: removeUserFromOrganization
813
+ description: Remove User from Organization
814
+ operationId: removeUserFromOrganization
815
+ parameters:
816
+ - name: organization_membership_id
817
+ in: path
818
+ description: The organization membership
819
+ required: true
820
+ style: simple
821
+ schema:
822
+ type: string
823
+ responses:
824
+ '200':
825
+ description: successful operation
826
+ headers: {}
827
+ content:
828
+ text/plain:
829
+ schema:
830
+ type: string
831
+ description: successful operation
832
+ '400':
833
+ description: failed operation
834
+ headers: {}
835
+ content: {}
836
+ deprecated: false
837
+ /organizations/{organization_name}/authentication-token:
838
+ post:
839
+ tags:
840
+ - OrganizationToken
841
+ summary: generateOrganizationToken
842
+ description: Generate a new organization token
843
+ operationId: generateOrganizationToken
844
+ parameters:
845
+ - name: organization_name
846
+ in: path
847
+ description: The name of the organization to generate a token for.
848
+ required: true
849
+ style: simple
850
+ schema:
851
+ type: string
852
+ responses:
853
+ '200':
854
+ description: successful operation
855
+ headers: {}
856
+ content:
857
+ text/plain:
858
+ schema:
859
+ type: string
860
+ description: successful operation
861
+ '400':
862
+ description: failed operation
863
+ headers: {}
864
+ content: {}
865
+ deprecated: false
866
+ delete:
867
+ tags:
868
+ - OrganizationToken
869
+ summary: deleteOrganizationToken
870
+ description: Delete the organization token
871
+ operationId: deleteOrganizationToken
872
+ parameters:
873
+ - name: organization_name
874
+ in: path
875
+ description: Which organization's token should be deleted.
876
+ required: true
877
+ style: simple
878
+ schema:
879
+ type: string
880
+ responses:
881
+ '200':
882
+ description: successful operation
883
+ headers: {}
884
+ content:
885
+ text/plain:
886
+ schema:
887
+ type: string
888
+ description: successful operation
889
+ '400':
890
+ description: failed operation
891
+ headers: {}
892
+ content: {}
893
+ deprecated: false
894
+ /plan-exports:
895
+ post:
896
+ tags:
897
+ - PlanExports
898
+ summary: createPlanExport
899
+ description: This endpoint exports data from a plan in the specified format. The export process is asynchronous, and the resulting data becomes downloadable when its status is "finished". The data is then available for one hour before expiring. After the hour is up, a new export can be created.
900
+ operationId: createPlanExport
901
+ parameters: []
902
+ requestBody:
903
+ description: ''
904
+ content:
905
+ text/plain:
906
+ schema:
907
+ type: string
908
+ required: false
909
+ responses:
910
+ '200':
911
+ description: successful operation
912
+ headers: {}
913
+ content:
914
+ text/plain:
915
+ schema:
916
+ type: string
917
+ description: successful operation
918
+ '400':
919
+ description: failed operation
920
+ headers: {}
921
+ content: {}
922
+ deprecated: false
923
+ /plan-exports/{id}:
924
+ get:
925
+ tags:
926
+ - PlanExports
927
+ summary: showPlanExport
928
+ description: Show a plan export
929
+ operationId: showPlanExport
930
+ parameters:
931
+ - name: id
932
+ in: path
933
+ description: The ID of the plan export to show.
934
+ required: true
935
+ style: simple
936
+ schema:
937
+ type: string
938
+ responses:
939
+ '200':
940
+ description: successful operation
941
+ headers: {}
942
+ content:
943
+ text/plain:
944
+ schema:
945
+ type: string
946
+ description: successful operation
947
+ '400':
948
+ description: failed operation
949
+ headers: {}
950
+ content: {}
951
+ deprecated: false
952
+ delete:
953
+ tags:
954
+ - PlanExports
955
+ summary: Deleteexportedplandata
956
+ description: Plan exports expire after being available for one hour, but they can be deleted manually as well.
957
+ operationId: Deleteexportedplandata
958
+ parameters:
959
+ - name: id
960
+ in: path
961
+ description: The ID of the plan export
962
+ required: true
963
+ style: simple
964
+ schema:
965
+ type: string
966
+ responses:
967
+ '200':
968
+ description: successful operation
969
+ headers: {}
970
+ content:
971
+ text/plain:
972
+ schema:
973
+ type: string
974
+ description: successful operation
975
+ '400':
976
+ description: failed operation
977
+ headers: {}
978
+ content: {}
979
+ deprecated: false
980
+ /plan-exports/{id}/download:
981
+ get:
982
+ tags:
983
+ - PlanExports
984
+ summary: downloadPlanExport
985
+ description: This endpoint generates a temporary URL to the location of the exported plan data in a .tar.gz archive, and then redirects to that link. If using a client that can follow redirects, you can use this endpoint to save the .tar.gz archive locally without needing to save the temporary URL.
986
+ operationId: downloadPlanExport
987
+ parameters:
988
+ - name: id
989
+ in: path
990
+ description: The ID of the plan export.
991
+ required: true
992
+ style: simple
993
+ schema:
994
+ type: string
995
+ responses:
996
+ '200':
997
+ description: successful operation
998
+ headers: {}
999
+ content:
1000
+ text/plain:
1001
+ schema:
1002
+ type: string
1003
+ description: successful operation
1004
+ '400':
1005
+ description: failed operation
1006
+ headers: {}
1007
+ content: {}
1008
+ deprecated: false
1009
+ /plans/{id}:
1010
+ get:
1011
+ tags:
1012
+ - Plans
1013
+ summary: showPlan
1014
+ description: Show a plan
1015
+ operationId: showPlan
1016
+ parameters:
1017
+ - name: id
1018
+ in: path
1019
+ description: The ID of the plan to show
1020
+ required: true
1021
+ style: simple
1022
+ schema:
1023
+ type: string
1024
+ responses:
1025
+ '200':
1026
+ description: successful operation
1027
+ headers: {}
1028
+ content:
1029
+ text/plain:
1030
+ schema:
1031
+ type: string
1032
+ description: successful operation
1033
+ '400':
1034
+ description: failed operation
1035
+ headers: {}
1036
+ content: {}
1037
+ deprecated: false
1038
+ /organizations/{organization_name}/policies:
1039
+ post:
1040
+ tags:
1041
+ - Policies
1042
+ summary: createPolicy
1043
+ description: Create a Policy
1044
+ operationId: createPolicy
1045
+ parameters:
1046
+ - name: organization_name
1047
+ in: path
1048
+ description: The organization to create the policy in. The organization must already exist in the system, and the token authenticating the API request must belong to the "owners" team or a member of the "owners" team.
1049
+ required: true
1050
+ style: simple
1051
+ schema:
1052
+ type: string
1053
+ requestBody:
1054
+ description: ''
1055
+ content:
1056
+ text/plain:
1057
+ schema:
1058
+ type: string
1059
+ required: false
1060
+ responses:
1061
+ '200':
1062
+ description: successful operation
1063
+ headers: {}
1064
+ content:
1065
+ text/plain:
1066
+ schema:
1067
+ type: string
1068
+ description: successful operation
1069
+ '400':
1070
+ description: failed operation
1071
+ headers: {}
1072
+ content: {}
1073
+ deprecated: false
1074
+ get:
1075
+ tags:
1076
+ - Policies
1077
+ summary: listPolicies
1078
+ description: List Policies
1079
+ operationId: listPolicies
1080
+ parameters:
1081
+ - name: organization_name
1082
+ in: path
1083
+ description: The organization to list policies for.
1084
+ required: true
1085
+ style: simple
1086
+ schema:
1087
+ type: string
1088
+ - name: page[number]
1089
+ in: query
1090
+ description: Optional. If omitted, the endpoint will return the first page.
1091
+ style: form
1092
+ explode: true
1093
+ schema:
1094
+ type: string
1095
+ - name: page[size]
1096
+ in: query
1097
+ description: Optional. If omitted, the endpoint will return 20 policies per page.
1098
+ style: form
1099
+ explode: true
1100
+ schema:
1101
+ type: string
1102
+ - name: search[name]
1103
+ in: query
1104
+ description: Optional. Allows searching the organization's policies by name.
1105
+ style: form
1106
+ explode: true
1107
+ schema:
1108
+ type: string
1109
+ responses:
1110
+ '200':
1111
+ description: successful operation
1112
+ headers: {}
1113
+ content:
1114
+ text/plain:
1115
+ schema:
1116
+ type: string
1117
+ description: successful operation
1118
+ '400':
1119
+ description: failed operation
1120
+ headers: {}
1121
+ content: {}
1122
+ deprecated: false
1123
+ /policies/{policy_id}:
1124
+ get:
1125
+ tags:
1126
+ - Policies
1127
+ summary: showPolicy
1128
+ description: Show a Policy
1129
+ operationId: showPolicy
1130
+ parameters:
1131
+ - name: policy_id
1132
+ in: path
1133
+ description: The ID of the policy to show. Use the "List Policies" endpoint to find IDs.
1134
+ required: true
1135
+ style: simple
1136
+ schema:
1137
+ type: string
1138
+ responses:
1139
+ '200':
1140
+ description: successful operation
1141
+ headers: {}
1142
+ content:
1143
+ text/plain:
1144
+ schema:
1145
+ type: string
1146
+ description: successful operation
1147
+ '400':
1148
+ description: failed operation
1149
+ headers: {}
1150
+ content: {}
1151
+ deprecated: false
1152
+ patch:
1153
+ tags:
1154
+ - Policies
1155
+ summary: updatePolicy
1156
+ description: This endpoint can update the enforcement mode of an existing policy. To update the policy code itself, use the upload endpoint.
1157
+ operationId: updatePolicy
1158
+ parameters:
1159
+ - name: policy_id
1160
+ in: path
1161
+ description: The ID of the policy to update. Use the "List Policies" endpoint to find IDs.
1162
+ required: true
1163
+ style: simple
1164
+ schema:
1165
+ type: string
1166
+ requestBody:
1167
+ description: ''
1168
+ content:
1169
+ text/plain:
1170
+ schema:
1171
+ type: string
1172
+ required: false
1173
+ responses:
1174
+ '200':
1175
+ description: successful operation
1176
+ headers: {}
1177
+ content:
1178
+ text/plain:
1179
+ schema:
1180
+ type: string
1181
+ description: successful operation
1182
+ '400':
1183
+ description: failed operation
1184
+ headers: {}
1185
+ content: {}
1186
+ deprecated: false
1187
+ delete:
1188
+ tags:
1189
+ - Policies
1190
+ summary: deletePolicy
1191
+ description: Delete a Policy
1192
+ operationId: deletePolicy
1193
+ parameters:
1194
+ - name: policy_id
1195
+ in: path
1196
+ description: The ID of the policy to delete. Use the "List Policies" endpoint to find IDs.
1197
+ required: true
1198
+ style: simple
1199
+ schema:
1200
+ type: string
1201
+ responses:
1202
+ '200':
1203
+ description: successful operation
1204
+ headers: {}
1205
+ content:
1206
+ text/plain:
1207
+ schema:
1208
+ type: string
1209
+ description: successful operation
1210
+ '400':
1211
+ description: failed operation
1212
+ headers: {}
1213
+ content: {}
1214
+ deprecated: false
1215
+ /policies/{policy_id}/upload:
1216
+ put:
1217
+ tags:
1218
+ - Policies
1219
+ summary: uploadPolicy
1220
+ description: Upload a Policy
1221
+ operationId: uploadPolicy
1222
+ parameters:
1223
+ - name: policy_id
1224
+ in: path
1225
+ description: The ID of the policy to upload code to. Use the "List Policies" endpoint (or the response to a "Create Policy" request) to find IDs.
1226
+ required: true
1227
+ style: simple
1228
+ schema:
1229
+ type: string
1230
+ responses:
1231
+ '200':
1232
+ description: successful operation
1233
+ headers: {}
1234
+ content:
1235
+ text/plain:
1236
+ schema:
1237
+ type: string
1238
+ description: successful operation
1239
+ '400':
1240
+ description: failed operation
1241
+ headers: {}
1242
+ content: {}
1243
+ deprecated: false
1244
+ /runs/{run_id}/policy-checks:
1245
+ get:
1246
+ tags:
1247
+ - PolicyChecks
1248
+ summary: listPolicyChecks
1249
+ description: This endpoint lists the policy checks in a run.
1250
+ operationId: listPolicyChecks
1251
+ parameters:
1252
+ - name: run_id
1253
+ in: path
1254
+ description: specifies the run ID for which to list policy checks
1255
+ required: true
1256
+ style: simple
1257
+ schema:
1258
+ type: string
1259
+ responses:
1260
+ '200':
1261
+ description: successful operation
1262
+ headers: {}
1263
+ content:
1264
+ text/plain:
1265
+ schema:
1266
+ type: string
1267
+ description: successful operation
1268
+ '400':
1269
+ description: failed operation
1270
+ headers: {}
1271
+ content: {}
1272
+ deprecated: false
1273
+ /policy-checks/{policy_check_id}/actions/override:
1274
+ post:
1275
+ tags:
1276
+ - PolicyChecks
1277
+ summary: overridePolicy
1278
+ description: This endpoint overrides a soft-mandatory or warning policy.
1279
+ operationId: overridePolicy
1280
+ parameters:
1281
+ - name: policy_check_id
1282
+ in: path
1283
+ description: specifies the ID for the policy check to override
1284
+ required: true
1285
+ style: simple
1286
+ schema:
1287
+ type: string
1288
+ responses:
1289
+ '200':
1290
+ description: successful operation
1291
+ headers: {}
1292
+ content:
1293
+ text/plain:
1294
+ schema:
1295
+ type: string
1296
+ description: successful operation
1297
+ '400':
1298
+ description: failed operation
1299
+ headers: {}
1300
+ content: {}
1301
+ deprecated: false
1302
+ /organizations/{organization_name}/policy-sets:
1303
+ post:
1304
+ tags:
1305
+ - PolicySets
1306
+ summary: createPolicySet
1307
+ description: Create a Policy Set
1308
+ operationId: createPolicySet
1309
+ parameters:
1310
+ - name: organization_name
1311
+ in: path
1312
+ description: The organization to create the policy set in. The organization must already exist in the system, and the token authenticating the API request must belong to the "owners" team or a member of the "owners" team.
1313
+ required: true
1314
+ style: simple
1315
+ schema:
1316
+ type: string
1317
+ requestBody:
1318
+ description: ''
1319
+ content:
1320
+ text/plain:
1321
+ schema:
1322
+ type: string
1323
+ required: false
1324
+ responses:
1325
+ '200':
1326
+ description: successful operation
1327
+ headers: {}
1328
+ content:
1329
+ text/plain:
1330
+ schema:
1331
+ type: string
1332
+ description: successful operation
1333
+ '400':
1334
+ description: failed operation
1335
+ headers: {}
1336
+ content: {}
1337
+ deprecated: false
1338
+ get:
1339
+ tags:
1340
+ - PolicySets
1341
+ summary: listPolicySets
1342
+ description: List Policy Sets
1343
+ operationId: listPolicySets
1344
+ parameters:
1345
+ - name: organization_name
1346
+ in: path
1347
+ description: The organization to list policy sets for.
1348
+ required: true
1349
+ style: simple
1350
+ schema:
1351
+ type: string
1352
+ - name: filter[versioned]
1353
+ in: query
1354
+ description: Optional. Allows filtering policy sets based on whether they are versioned (VCS-managed or API-managed), or use individual policy relationships. Accepts a boolean true/false value. A true value returns versioned sets, and a false value returns sets with individual policy relationships. If omitted, all policy sets are returned.
1355
+ style: form
1356
+ explode: true
1357
+ schema:
1358
+ type: string
1359
+ - name: include
1360
+ in: query
1361
+ description: Optional. Allows including related resource data. Value must be a comma-separated list containing one or more of workspaces, policies, newest_version, or current_version. See the relationships section for details.
1362
+ style: form
1363
+ explode: true
1364
+ schema:
1365
+ type: string
1366
+ - name: page[number]
1367
+ in: query
1368
+ description: Optional. If omitted, the endpoint will return the first page.
1369
+ style: form
1370
+ explode: true
1371
+ schema:
1372
+ type: string
1373
+ - name: page[size]
1374
+ in: query
1375
+ description: Optional. If omitted, the endpoint will return 20 policy sets per page.
1376
+ style: form
1377
+ explode: true
1378
+ schema:
1379
+ type: string
1380
+ - name: search[name]
1381
+ in: query
1382
+ description: Optional. Allows searching the organization's policy sets by name.
1383
+ style: form
1384
+ explode: true
1385
+ schema:
1386
+ type: string
1387
+ responses:
1388
+ '200':
1389
+ description: successful operation
1390
+ headers: {}
1391
+ content:
1392
+ text/plain:
1393
+ schema:
1394
+ type: string
1395
+ description: successful operation
1396
+ '400':
1397
+ description: failed operation
1398
+ headers: {}
1399
+ content: {}
1400
+ deprecated: false
1401
+ /policy-sets/{id}:
1402
+ get:
1403
+ tags:
1404
+ - PolicySets
1405
+ summary: showPolicySet
1406
+ description: Show a Policy Set
1407
+ operationId: showPolicySet
1408
+ parameters:
1409
+ - name: id
1410
+ in: path
1411
+ description: The ID of the policy set to show. Use the "List Policy Sets" endpoint to find IDs.
1412
+ required: true
1413
+ style: simple
1414
+ schema:
1415
+ type: string
1416
+ responses:
1417
+ '200':
1418
+ description: successful operation
1419
+ headers: {}
1420
+ content:
1421
+ text/plain:
1422
+ schema:
1423
+ type: string
1424
+ description: successful operation
1425
+ '400':
1426
+ description: failed operation
1427
+ headers: {}
1428
+ content: {}
1429
+ deprecated: false
1430
+ patch:
1431
+ tags:
1432
+ - PolicySets
1433
+ summary: updatePolicySet
1434
+ description: Update a Policy Set
1435
+ operationId: updatePolicySet
1436
+ parameters:
1437
+ - name: id
1438
+ in: path
1439
+ description: The ID of the policy set to update. Use the "List Policy Sets" endpoint to find IDs.
1440
+ required: true
1441
+ style: simple
1442
+ schema:
1443
+ type: string
1444
+ requestBody:
1445
+ description: ''
1446
+ content:
1447
+ text/plain:
1448
+ schema:
1449
+ type: string
1450
+ required: false
1451
+ responses:
1452
+ '200':
1453
+ description: successful operation
1454
+ headers: {}
1455
+ content:
1456
+ text/plain:
1457
+ schema:
1458
+ type: string
1459
+ description: successful operation
1460
+ '400':
1461
+ description: failed operation
1462
+ headers: {}
1463
+ content: {}
1464
+ deprecated: false
1465
+ delete:
1466
+ tags:
1467
+ - PolicySets
1468
+ summary: deletePolicySet
1469
+ description: Delete a Policy Set
1470
+ operationId: deletePolicySet
1471
+ parameters:
1472
+ - name: id
1473
+ in: path
1474
+ description: The ID of the policy set to delete. Use the "List Policy Sets" endpoint to find IDs.
1475
+ required: true
1476
+ style: simple
1477
+ schema:
1478
+ type: string
1479
+ responses:
1480
+ '200':
1481
+ description: successful operation
1482
+ headers: {}
1483
+ content:
1484
+ text/plain:
1485
+ schema:
1486
+ type: string
1487
+ description: successful operation
1488
+ '400':
1489
+ description: failed operation
1490
+ headers: {}
1491
+ content: {}
1492
+ deprecated: false
1493
+ /policy-sets/{id}/relationships/policies:
1494
+ post:
1495
+ tags:
1496
+ - PolicySets
1497
+ summary: addPoliciesToPolicySet
1498
+ description: Add Policies to the Policy Set
1499
+ operationId: addPoliciesToPolicySet
1500
+ parameters:
1501
+ - name: id
1502
+ in: path
1503
+ description: The ID of the policy set to add policies to. Use the "List Policy Sets" endpoint to find IDs.
1504
+ required: true
1505
+ style: simple
1506
+ schema:
1507
+ type: string
1508
+ requestBody:
1509
+ description: ''
1510
+ content:
1511
+ text/plain:
1512
+ schema:
1513
+ type: string
1514
+ required: false
1515
+ responses:
1516
+ '200':
1517
+ description: successful operation
1518
+ headers: {}
1519
+ content:
1520
+ text/plain:
1521
+ schema:
1522
+ type: string
1523
+ description: successful operation
1524
+ '400':
1525
+ description: failed operation
1526
+ headers: {}
1527
+ content: {}
1528
+ deprecated: false
1529
+ delete:
1530
+ tags:
1531
+ - PolicySets
1532
+ summary: removePoliciesFromThePolicySet
1533
+ description: Remove Policies from the Policy Set
1534
+ operationId: removePoliciesFromThePolicySet
1535
+ parameters:
1536
+ - name: id
1537
+ in: path
1538
+ description: The ID of the policy set to remove policies from. Use the "List Policy Sets" endpoint to find IDs.
1539
+ required: true
1540
+ style: simple
1541
+ schema:
1542
+ type: string
1543
+ responses:
1544
+ '200':
1545
+ description: successful operation
1546
+ headers: {}
1547
+ content:
1548
+ text/plain:
1549
+ schema:
1550
+ type: string
1551
+ description: successful operation
1552
+ '400':
1553
+ description: failed operation
1554
+ headers: {}
1555
+ content: {}
1556
+ deprecated: false
1557
+ /policy-sets/{id}/relationships/workspaces:
1558
+ post:
1559
+ tags:
1560
+ - PolicySets
1561
+ summary: attachPolicySetToWorkspaces
1562
+ description: Attach a Policy Set to workspaces
1563
+ operationId: attachPolicySetToWorkspaces
1564
+ parameters:
1565
+ - name: id
1566
+ in: path
1567
+ description: The ID of the policy set to attach to workspaces. Use the "List Policy Sets" endpoint to find IDs.
1568
+ required: true
1569
+ style: simple
1570
+ schema:
1571
+ type: string
1572
+ requestBody:
1573
+ description: ''
1574
+ content:
1575
+ text/plain:
1576
+ schema:
1577
+ type: string
1578
+ required: false
1579
+ responses:
1580
+ '200':
1581
+ description: successful operation
1582
+ headers: {}
1583
+ content:
1584
+ text/plain:
1585
+ schema:
1586
+ type: string
1587
+ description: successful operation
1588
+ '400':
1589
+ description: failed operation
1590
+ headers: {}
1591
+ content: {}
1592
+ deprecated: false
1593
+ delete:
1594
+ tags:
1595
+ - PolicySets
1596
+ summary: detachthePolicySetFromWorkspaces
1597
+ description: Detach the Policy Set from workspaces
1598
+ operationId: detachthePolicySetFromWorkspaces
1599
+ parameters:
1600
+ - name: id
1601
+ in: path
1602
+ description: The ID of the policy set to detach from workspaces. Use the "List Policy Sets" endpoint to find IDs.
1603
+ required: true
1604
+ style: simple
1605
+ schema:
1606
+ type: string
1607
+ responses:
1608
+ '200':
1609
+ description: successful operation
1610
+ headers: {}
1611
+ content:
1612
+ text/plain:
1613
+ schema:
1614
+ type: string
1615
+ description: successful operation
1616
+ '400':
1617
+ description: failed operation
1618
+ headers: {}
1619
+ content: {}
1620
+ deprecated: false
1621
+ /policy-sets/{id}/versions:
1622
+ post:
1623
+ tags:
1624
+ - PolicySets
1625
+ summary: createPolicySetVersion
1626
+ description: For versioned policy sets which have no VCS repository attached, versions of policy code may be uploaded directly to the API by creating a new policy set version and, in a subsequent request, uploading a tarball (tar.gz) of data to it.
1627
+ operationId: createPolicySetVersion
1628
+ parameters:
1629
+ - name: id
1630
+ in: path
1631
+ description: The ID of the policy set to create a new version for.
1632
+ required: true
1633
+ style: simple
1634
+ schema:
1635
+ type: string
1636
+ responses:
1637
+ '200':
1638
+ description: successful operation
1639
+ headers: {}
1640
+ content:
1641
+ text/plain:
1642
+ schema:
1643
+ type: string
1644
+ description: successful operation
1645
+ '400':
1646
+ description: failed operation
1647
+ headers: {}
1648
+ content: {}
1649
+ deprecated: false
1650
+ /policy-set-versions/{id}:
1651
+ get:
1652
+ tags:
1653
+ - PolicySets
1654
+ summary: showPolicySetVersion
1655
+ description: Show a Policy Set Version
1656
+ operationId: showPolicySetVersion
1657
+ parameters:
1658
+ - name: id
1659
+ in: path
1660
+ description: The ID of the policy set version to show.
1661
+ required: true
1662
+ style: simple
1663
+ schema:
1664
+ type: string
1665
+ responses:
1666
+ '200':
1667
+ description: successful operation
1668
+ headers: {}
1669
+ content:
1670
+ text/plain:
1671
+ schema:
1672
+ type: string
1673
+ description: successful operation
1674
+ '400':
1675
+ description: failed operation
1676
+ headers: {}
1677
+ content: {}
1678
+ deprecated: false
1679
+ /policy-sets/{policy_set_id}/parameters:
1680
+ post:
1681
+ tags:
1682
+ - PolicySetParameters
1683
+ summary: createParameter
1684
+ description: Create a Parameter
1685
+ operationId: createParameter
1686
+ parameters:
1687
+ - name: policy_set_id
1688
+ in: path
1689
+ description: The ID of the policy set to create the parameter in.
1690
+ required: true
1691
+ style: simple
1692
+ schema:
1693
+ type: string
1694
+ requestBody:
1695
+ description: ''
1696
+ content:
1697
+ text/plain:
1698
+ schema:
1699
+ type: string
1700
+ required: false
1701
+ responses:
1702
+ '200':
1703
+ description: successful operation
1704
+ headers: {}
1705
+ content:
1706
+ text/plain:
1707
+ schema:
1708
+ type: string
1709
+ description: successful operation
1710
+ '400':
1711
+ description: failed operation
1712
+ headers: {}
1713
+ content: {}
1714
+ deprecated: false
1715
+ get:
1716
+ tags:
1717
+ - PolicySetParameters
1718
+ summary: listParameters
1719
+ description: List Parameters
1720
+ operationId: listParameters
1721
+ parameters:
1722
+ - name: policy_set_id
1723
+ in: path
1724
+ description: The ID of the policy set to list parameters for.
1725
+ required: true
1726
+ style: simple
1727
+ schema:
1728
+ type: string
1729
+ responses:
1730
+ '200':
1731
+ description: successful operation
1732
+ headers: {}
1733
+ content:
1734
+ text/plain:
1735
+ schema:
1736
+ type: string
1737
+ description: successful operation
1738
+ '400':
1739
+ description: failed operation
1740
+ headers: {}
1741
+ content: {}
1742
+ deprecated: false
1743
+ /policy-sets/{policy_set_id}/parameters/{parameter_id}:
1744
+ patch:
1745
+ tags:
1746
+ - PolicySetParameters
1747
+ summary: updateParameters
1748
+ description: Update Parameters
1749
+ operationId: updateParameters
1750
+ parameters:
1751
+ - name: policy_set_id
1752
+ in: path
1753
+ description: The ID of the policy set that owns the parameter.
1754
+ required: true
1755
+ style: simple
1756
+ schema:
1757
+ type: string
1758
+ - name: parameter_id
1759
+ in: path
1760
+ description: The ID of the parameter to be updated.
1761
+ required: true
1762
+ style: simple
1763
+ schema:
1764
+ type: string
1765
+ requestBody:
1766
+ description: ''
1767
+ content:
1768
+ text/plain:
1769
+ schema:
1770
+ type: string
1771
+ required: false
1772
+ responses:
1773
+ '200':
1774
+ description: successful operation
1775
+ headers: {}
1776
+ content:
1777
+ text/plain:
1778
+ schema:
1779
+ type: string
1780
+ description: successful operation
1781
+ '400':
1782
+ description: failed operation
1783
+ headers: {}
1784
+ content: {}
1785
+ deprecated: false
1786
+ delete:
1787
+ tags:
1788
+ - PolicySetParameters
1789
+ summary: deleteParameters
1790
+ description: Delete Parameters
1791
+ operationId: deleteParameters
1792
+ parameters:
1793
+ - name: policy_set_id
1794
+ in: path
1795
+ description: The ID of the policy set that owns the parameter.
1796
+ required: true
1797
+ style: simple
1798
+ schema:
1799
+ type: string
1800
+ - name: parameter_id
1801
+ in: path
1802
+ description: The ID of the parameter to be deleted.
1803
+ required: true
1804
+ style: simple
1805
+ schema:
1806
+ type: string
1807
+ responses:
1808
+ '200':
1809
+ description: successful operation
1810
+ headers: {}
1811
+ content:
1812
+ text/plain:
1813
+ schema:
1814
+ type: string
1815
+ description: successful operation
1816
+ '400':
1817
+ description: failed operation
1818
+ headers: {}
1819
+ content: {}
1820
+ deprecated: false
1821
+ /runs:
1822
+ post:
1823
+ tags:
1824
+ - Runs
1825
+ summary: createRun
1826
+ description: A run performs a plan and apply, using a configuration version and the workspace’s current variables. You can specify a configuration version when creating a run; if you don’t provide one, the run defaults to the workspace’s most recently used version. (A configuration version is “used” when it is created or used for a run in this workspace.)
1827
+ operationId: createRun
1828
+ parameters: []
1829
+ requestBody:
1830
+ description: ''
1831
+ content:
1832
+ text/plain:
1833
+ schema:
1834
+ type: string
1835
+ required: false
1836
+ responses:
1837
+ '200':
1838
+ description: successful operation
1839
+ headers: {}
1840
+ content:
1841
+ text/plain:
1842
+ schema:
1843
+ type: string
1844
+ description: successful operation
1845
+ '400':
1846
+ description: failed operation
1847
+ headers: {}
1848
+ content: {}
1849
+ deprecated: false
1850
+ /runs/{run_id}/actions/apply:
1851
+ post:
1852
+ tags:
1853
+ - Runs
1854
+ summary: applyRun
1855
+ description: Applies a run that is paused waiting for confirmation after a plan. This includes runs in the "needs confirmation" and "policy checked" states. This action is only required for runs that can't be auto-applied. (Plans can be auto-applied if the auto-apply setting is enabled on the workspace and the plan was queued by a new VCS commit or by a user with write permissions.)
1856
+ operationId: applyRun
1857
+ parameters:
1858
+ - name: run_id
1859
+ in: path
1860
+ description: The run ID to apply
1861
+ required: true
1862
+ style: simple
1863
+ schema:
1864
+ type: string
1865
+ requestBody:
1866
+ description: ''
1867
+ content:
1868
+ text/plain:
1869
+ schema:
1870
+ type: string
1871
+ required: false
1872
+ responses:
1873
+ '200':
1874
+ description: successful operation
1875
+ headers: {}
1876
+ content:
1877
+ text/plain:
1878
+ schema:
1879
+ type: string
1880
+ description: successful operation
1881
+ '400':
1882
+ description: failed operation
1883
+ headers: {}
1884
+ content: {}
1885
+ deprecated: false
1886
+ /workspaces/{workspace_id}/runs:
1887
+ get:
1888
+ tags:
1889
+ - Runs
1890
+ summary: ListRuns
1891
+ description: List Runs in a Workspace
1892
+ operationId: ListRuns
1893
+ parameters:
1894
+ - name: workspace_id
1895
+ in: path
1896
+ description: The workspace ID to list runs for.
1897
+ required: true
1898
+ style: simple
1899
+ schema:
1900
+ type: string
1901
+ - name: page[number]
1902
+ in: query
1903
+ description: Page Number
1904
+ style: form
1905
+ explode: true
1906
+ schema:
1907
+ type: number
1908
+ format: double
1909
+ - name: page[size]
1910
+ in: query
1911
+ description: Page Size
1912
+ style: form
1913
+ explode: true
1914
+ schema:
1915
+ type: number
1916
+ format: double
1917
+ responses:
1918
+ '200':
1919
+ description: successful operation
1920
+ headers: {}
1921
+ content:
1922
+ text/plain:
1923
+ schema:
1924
+ type: string
1925
+ description: successful operation
1926
+ '400':
1927
+ description: failed operation
1928
+ headers: {}
1929
+ content: {}
1930
+ deprecated: false
1931
+ /runs/{run_id}:
1932
+ get:
1933
+ tags:
1934
+ - Runs
1935
+ summary: GetRunDetails
1936
+ description: This endpoint is used for showing details of a specific run.
1937
+ operationId: GetRunDetails
1938
+ parameters:
1939
+ - name: run_id
1940
+ in: path
1941
+ description: The run ID to get.
1942
+ required: true
1943
+ style: simple
1944
+ schema:
1945
+ type: string
1946
+ responses:
1947
+ '200':
1948
+ description: successful operation
1949
+ headers: {}
1950
+ content:
1951
+ text/plain:
1952
+ schema:
1953
+ type: string
1954
+ description: successful operation
1955
+ '400':
1956
+ description: failed operation
1957
+ headers: {}
1958
+ content: {}
1959
+ deprecated: false
1960
+ /runs/{run_id}/actions/discard:
1961
+ post:
1962
+ tags:
1963
+ - Runs
1964
+ summary: DiscardRun
1965
+ description: The discard action can be used to skip any remaining work on runs that are paused waiting for confirmation or priority. This includes runs in the "pending," "needs confirmation," "policy checked," and "policy override" states.
1966
+ operationId: DiscardRun
1967
+ parameters:
1968
+ - name: run_id
1969
+ in: path
1970
+ description: The run ID to discard
1971
+ required: true
1972
+ style: simple
1973
+ schema:
1974
+ type: string
1975
+ requestBody:
1976
+ description: ''
1977
+ content:
1978
+ text/plain:
1979
+ schema:
1980
+ type: string
1981
+ required: false
1982
+ responses:
1983
+ '200':
1984
+ description: successful operation
1985
+ headers: {}
1986
+ content:
1987
+ text/plain:
1988
+ schema:
1989
+ type: string
1990
+ description: successful operation
1991
+ '400':
1992
+ description: failed operation
1993
+ headers: {}
1994
+ content: {}
1995
+ deprecated: false
1996
+ /runs/{run_id}/actions/cancel:
1997
+ post:
1998
+ tags:
1999
+ - Runs
2000
+ summary: cancelRun
2001
+ description: The cancel action can be used to interrupt a run that is currently planning or applying. Performing a cancel is roughly equivalent to hitting ctrl+c during a Terraform plan or apply on the CLI. The running Terraform process is sent an INT signal, which instructs Terraform to end its work and wrap up in the safest way possible.
2002
+ operationId: cancelRun
2003
+ parameters:
2004
+ - name: run_id
2005
+ in: path
2006
+ description: The run ID to cancel
2007
+ required: true
2008
+ style: simple
2009
+ schema:
2010
+ type: string
2011
+ requestBody:
2012
+ description: ''
2013
+ content:
2014
+ text/plain:
2015
+ schema:
2016
+ type: string
2017
+ required: false
2018
+ responses:
2019
+ '200':
2020
+ description: successful operation
2021
+ headers: {}
2022
+ content:
2023
+ text/plain:
2024
+ schema:
2025
+ type: string
2026
+ description: successful operation
2027
+ '400':
2028
+ description: failed operation
2029
+ headers: {}
2030
+ content: {}
2031
+ deprecated: false
2032
+ /runs/{run_id}/actions/force-cancel:
2033
+ post:
2034
+ tags:
2035
+ - Runs
2036
+ summary: forceCancel
2037
+ description: The force-cancel action is like cancel, but ends the run immediately. Once invoked, the run is placed into a canceled state, and the running Terraform process is terminated. The workspace is immediately unlocked, allowing further runs to be queued. The force-cancel operation requires workspace admin privileges.
2038
+ operationId: forceCancel
2039
+ parameters:
2040
+ - name: run_id
2041
+ in: path
2042
+ description: The run ID to cancel
2043
+ required: true
2044
+ style: simple
2045
+ schema:
2046
+ type: string
2047
+ requestBody:
2048
+ description: ''
2049
+ content:
2050
+ text/plain:
2051
+ schema:
2052
+ type: string
2053
+ required: false
2054
+ responses:
2055
+ '200':
2056
+ description: successful operation
2057
+ headers: {}
2058
+ content:
2059
+ text/plain:
2060
+ schema:
2061
+ type: string
2062
+ description: successful operation
2063
+ '400':
2064
+ description: failed operation
2065
+ headers: {}
2066
+ content: {}
2067
+ deprecated: false
2068
+ /runs/{run_id}/actions/force-execute:
2069
+ get:
2070
+ tags:
2071
+ - Runs
2072
+ summary: forceExecute
2073
+ description: The force-execute action cancels all prior runs that are not already complete, unlocking the run's workspace and allowing the run to be executed. (It initiates the same actions as the "Run this plan now" button at the top of the view of a pending run.)
2074
+ operationId: forceExecute
2075
+ parameters:
2076
+ - name: run_id
2077
+ in: path
2078
+ description: The run ID to execute
2079
+ required: true
2080
+ style: simple
2081
+ schema:
2082
+ type: string
2083
+ responses:
2084
+ '200':
2085
+ description: successful operation
2086
+ headers: {}
2087
+ content:
2088
+ text/plain:
2089
+ schema:
2090
+ type: string
2091
+ description: successful operation
2092
+ '400':
2093
+ description: failed operation
2094
+ headers: {}
2095
+ content: {}
2096
+ deprecated: false
2097
+ /workspaces/{workspace_id}/state-versions:
2098
+ post:
2099
+ tags:
2100
+ - StateVersions
2101
+ summary: createStateVersion
2102
+ description: Create a State Version
2103
+ operationId: createStateVersion
2104
+ parameters:
2105
+ - name: workspace_id
2106
+ in: path
2107
+ description: The workspace ID to create the new state version in. Obtain this from the workspace settings or the Show Workspace endpoint.
2108
+ required: true
2109
+ style: simple
2110
+ schema:
2111
+ type: string
2112
+ requestBody:
2113
+ description: ''
2114
+ content:
2115
+ text/plain:
2116
+ schema:
2117
+ type: string
2118
+ required: false
2119
+ responses:
2120
+ '200':
2121
+ description: successful operation
2122
+ headers: {}
2123
+ content:
2124
+ text/plain:
2125
+ schema:
2126
+ type: string
2127
+ description: successful operation
2128
+ '400':
2129
+ description: failed operation
2130
+ headers: {}
2131
+ content: {}
2132
+ deprecated: false
2133
+ /state-versions:
2134
+ get:
2135
+ tags:
2136
+ - StateVersions
2137
+ summary: listStateVersions
2138
+ description: List State Versions for a Workspace
2139
+ operationId: listStateVersions
2140
+ parameters:
2141
+ - name: filter[workspace][name]
2142
+ in: query
2143
+ description: Required The name of one workspace to list versions for.
2144
+ style: form
2145
+ explode: true
2146
+ schema:
2147
+ type: string
2148
+ - name: filter[organization][name]
2149
+ in: query
2150
+ description: Required The name of the organization that owns the desired workspace.
2151
+ style: form
2152
+ explode: true
2153
+ schema:
2154
+ type: string
2155
+ - name: page[number]
2156
+ in: query
2157
+ description: Optional. If omitted, the endpoint will return the first page.
2158
+ style: form
2159
+ explode: true
2160
+ schema:
2161
+ type: string
2162
+ - name: page[size]
2163
+ in: query
2164
+ description: Optional. If omitted, the endpoint will return 20 state versions per page.
2165
+ style: form
2166
+ explode: true
2167
+ schema:
2168
+ type: string
2169
+ responses:
2170
+ '200':
2171
+ description: successful operation
2172
+ headers: {}
2173
+ content:
2174
+ text/plain:
2175
+ schema:
2176
+ type: string
2177
+ description: successful operation
2178
+ '400':
2179
+ description: failed operation
2180
+ headers: {}
2181
+ content: {}
2182
+ deprecated: false
2183
+ /workspaces/{workspace_id}/current-state-version:
2184
+ get:
2185
+ tags:
2186
+ - StateVersions
2187
+ summary: fetchCurrentStateVersionForWorkspace
2188
+ description: Fetch the Current State Version for a Workspace
2189
+ operationId: fetchCurrentStateVersionForWorkspace
2190
+ parameters:
2191
+ - name: workspace_id
2192
+ in: path
2193
+ description: The ID for the workspace whose current state version you want to fetch. Obtain this from the workspace settings or the Show Workspace endpoint.
2194
+ required: true
2195
+ style: simple
2196
+ schema:
2197
+ type: string
2198
+ responses:
2199
+ '200':
2200
+ description: successful operation
2201
+ headers: {}
2202
+ content:
2203
+ text/plain:
2204
+ schema:
2205
+ type: string
2206
+ description: successful operation
2207
+ '400':
2208
+ description: failed operation
2209
+ headers: {}
2210
+ content: {}
2211
+ deprecated: false
2212
+ /state-versions/{state_version_id}:
2213
+ get:
2214
+ tags:
2215
+ - StateVersions
2216
+ summary: showStateVersion
2217
+ description: Show a State Version
2218
+ operationId: showStateVersion
2219
+ parameters:
2220
+ - name: state_version_id
2221
+ in: path
2222
+ description: The ID of the desired state version.
2223
+ required: true
2224
+ style: simple
2225
+ schema:
2226
+ type: string
2227
+ responses:
2228
+ '200':
2229
+ description: successful operation
2230
+ headers: {}
2231
+ content:
2232
+ text/plain:
2233
+ schema:
2234
+ type: string
2235
+ description: successful operation
2236
+ '400':
2237
+ description: failed operation
2238
+ headers: {}
2239
+ content: {}
2240
+ deprecated: false
2241
+ /state-version-outputs/{state_version_output_id}:
2242
+ get:
2243
+ tags:
2244
+ - StateVersionOutputs
2245
+ summary: showStateVersionOutput
2246
+ description: Show a State Version Output
2247
+ operationId: showStateVersionOutput
2248
+ parameters:
2249
+ - name: state_version_output_id
2250
+ in: path
2251
+ description: The ID of the desired state version output.
2252
+ required: true
2253
+ style: simple
2254
+ schema:
2255
+ type: string
2256
+ responses:
2257
+ '200':
2258
+ description: successful operation
2259
+ headers: {}
2260
+ content:
2261
+ text/plain:
2262
+ schema:
2263
+ type: string
2264
+ description: successful operation
2265
+ '400':
2266
+ description: failed operation
2267
+ headers: {}
2268
+ content: {}
2269
+ deprecated: false
2270
+ /users/{user_id}:
2271
+ get:
2272
+ tags:
2273
+ - Users
2274
+ summary: showUser
2275
+ description: Shows details for a given user.
2276
+ operationId: showUser
2277
+ parameters:
2278
+ - name: user
2279
+ in: query
2280
+ description: The ID of the desired user.
2281
+ required: true
2282
+ style: form
2283
+ explode: true
2284
+ schema:
2285
+ type: string
2286
+ - name: user_id
2287
+ in: path
2288
+ description: ''
2289
+ required: true
2290
+ style: simple
2291
+ schema:
2292
+ type: string
2293
+ responses:
2294
+ '200':
2295
+ description: successful operation
2296
+ headers: {}
2297
+ content:
2298
+ text/plain:
2299
+ schema:
2300
+ type: string
2301
+ description: successful operation
2302
+ '400':
2303
+ description: failed operation
2304
+ headers: {}
2305
+ content: {}
2306
+ deprecated: false
2307
+ /vars:
2308
+ post:
2309
+ tags:
2310
+ - Variables
2311
+ summary: createVariable
2312
+ description: Create a Variable
2313
+ operationId: createVariable
2314
+ parameters: []
2315
+ requestBody:
2316
+ description: ''
2317
+ content:
2318
+ text/plain:
2319
+ schema:
2320
+ type: string
2321
+ required: false
2322
+ responses:
2323
+ '200':
2324
+ description: successful operation
2325
+ headers: {}
2326
+ content:
2327
+ text/plain:
2328
+ schema:
2329
+ type: string
2330
+ description: successful operation
2331
+ '400':
2332
+ description: failed operation
2333
+ headers: {}
2334
+ content: {}
2335
+ deprecated: false
2336
+ get:
2337
+ tags:
2338
+ - Variables
2339
+ summary: listVariables
2340
+ description: List Variables
2341
+ operationId: listVariables
2342
+ parameters:
2343
+ - name: filter[workspace][name]
2344
+ in: query
2345
+ description: Optional The name of one workspace to list variables for. If included, you must also include the organization name filter.
2346
+ style: form
2347
+ explode: true
2348
+ schema:
2349
+ type: string
2350
+ - name: filter[organization][name]
2351
+ in: query
2352
+ description: Optional The name of the organization that owns the desired workspace. If included, you must also included the workspace name filter.
2353
+ style: form
2354
+ explode: true
2355
+ schema:
2356
+ type: string
2357
+ responses:
2358
+ '200':
2359
+ description: successful operation
2360
+ headers: {}
2361
+ content:
2362
+ text/plain:
2363
+ schema:
2364
+ type: string
2365
+ description: successful operation
2366
+ '400':
2367
+ description: failed operation
2368
+ headers: {}
2369
+ content: {}
2370
+ deprecated: false
2371
+ /vars/{variable_id}:
2372
+ patch:
2373
+ tags:
2374
+ - Variables
2375
+ summary: updateVariables
2376
+ description: Update Variables
2377
+ operationId: updateVariables
2378
+ parameters:
2379
+ - name: variable_id
2380
+ in: path
2381
+ description: The ID of the variable to be updated.
2382
+ required: true
2383
+ style: simple
2384
+ schema:
2385
+ type: string
2386
+ requestBody:
2387
+ description: ''
2388
+ content:
2389
+ text/plain:
2390
+ schema:
2391
+ type: string
2392
+ required: false
2393
+ responses:
2394
+ '200':
2395
+ description: successful operation
2396
+ headers: {}
2397
+ content:
2398
+ text/plain:
2399
+ schema:
2400
+ type: string
2401
+ description: successful operation
2402
+ '400':
2403
+ description: failed operation
2404
+ headers: {}
2405
+ content: {}
2406
+ deprecated: false
2407
+ delete:
2408
+ tags:
2409
+ - Variables
2410
+ summary: deleteVariables
2411
+ description: Delete Variables
2412
+ operationId: deleteVariables
2413
+ parameters:
2414
+ - name: variable_id
2415
+ in: path
2416
+ description: The ID of the variable to be deleted.
2417
+ required: true
2418
+ style: simple
2419
+ schema:
2420
+ type: string
2421
+ responses:
2422
+ '200':
2423
+ description: successful operation
2424
+ headers: {}
2425
+ content:
2426
+ text/plain:
2427
+ schema:
2428
+ type: string
2429
+ description: successful operation
2430
+ '400':
2431
+ description: failed operation
2432
+ headers: {}
2433
+ content: {}
2434
+ deprecated: false
2435
+ /organizations/{organization_name}/workspaces:
2436
+ post:
2437
+ tags:
2438
+ - Workspaces
2439
+ summary: createWorkspace
2440
+ description: Create a Workspace
2441
+ operationId: createWorkspace
2442
+ parameters:
2443
+ - name: organization_name
2444
+ in: path
2445
+ description: The name of the organization to create the workspace in. The organization must already exist in the system, and the user must have permissions to create new workspaces.
2446
+ required: true
2447
+ style: simple
2448
+ schema:
2449
+ type: string
2450
+ requestBody:
2451
+ description: ''
2452
+ content:
2453
+ text/plain:
2454
+ schema:
2455
+ type: string
2456
+ required: false
2457
+ responses:
2458
+ '200':
2459
+ description: successful operation
2460
+ headers: {}
2461
+ content:
2462
+ text/plain:
2463
+ schema:
2464
+ type: string
2465
+ description: successful operation
2466
+ '400':
2467
+ description: failed operation
2468
+ headers: {}
2469
+ content: {}
2470
+ deprecated: false
2471
+ get:
2472
+ tags:
2473
+ - Workspaces
2474
+ summary: listWorkspaces
2475
+ description: List Workspaces
2476
+ operationId: listWorkspaces
2477
+ parameters:
2478
+ - name: organization_name
2479
+ in: path
2480
+ description: The name of the organization to list the workspaces of.
2481
+ required: true
2482
+ style: simple
2483
+ schema:
2484
+ type: string
2485
+ - name: page[number]
2486
+ in: query
2487
+ description: Optional. If omitted, the endpoint will return the first page.
2488
+ style: form
2489
+ explode: true
2490
+ schema:
2491
+ type: string
2492
+ - name: page[size]
2493
+ in: query
2494
+ description: Optional. If omitted, the endpoint will return 150 workspaces per page.
2495
+ style: form
2496
+ explode: true
2497
+ schema:
2498
+ type: string
2499
+ responses:
2500
+ '200':
2501
+ description: successful operation
2502
+ headers: {}
2503
+ content:
2504
+ text/plain:
2505
+ schema:
2506
+ type: string
2507
+ description: successful operation
2508
+ '400':
2509
+ description: failed operation
2510
+ headers: {}
2511
+ content: {}
2512
+ deprecated: false
2513
+ /workspaces/{workspace_id}:
2514
+ get:
2515
+ tags:
2516
+ - Workspaces
2517
+ summary: showWorkspace
2518
+ description: Details on a workspace can be retrieved from two endpoints, which behave identically. One refers to a workspace by its ID, and the other by its name and organization.
2519
+ operationId: showWorkspace
2520
+ parameters:
2521
+ - name: workspace_id
2522
+ in: path
2523
+ description: The workspace ID
2524
+ required: true
2525
+ style: simple
2526
+ schema:
2527
+ type: string
2528
+ responses:
2529
+ '200':
2530
+ description: successful operation
2531
+ headers: {}
2532
+ content:
2533
+ text/plain:
2534
+ schema:
2535
+ type: string
2536
+ description: successful operation
2537
+ '400':
2538
+ description: failed operation
2539
+ headers: {}
2540
+ content: {}
2541
+ deprecated: false
2542
+ /workspaces/{workspace_id}/actions/lock:
2543
+ post:
2544
+ tags:
2545
+ - Workspaces
2546
+ summary: lockWorkspace
2547
+ description: This endpoint locks a workspace.
2548
+ operationId: lockWorkspace
2549
+ parameters:
2550
+ - name: workspace_id
2551
+ in: path
2552
+ description: The workspace ID to lock. Obtain this from the workspace settings or the Show Workspace endpoint.
2553
+ required: true
2554
+ style: simple
2555
+ schema:
2556
+ type: object
2557
+ responses:
2558
+ '200':
2559
+ description: successful operation
2560
+ headers: {}
2561
+ content:
2562
+ text/plain:
2563
+ schema:
2564
+ type: string
2565
+ description: successful operation
2566
+ '400':
2567
+ description: failed operation
2568
+ headers: {}
2569
+ content: {}
2570
+ deprecated: false
2571
+ /workspaces/{workspace_id}/actions/unlock:
2572
+ post:
2573
+ tags:
2574
+ - Workspaces
2575
+ summary: unlockWorkspace
2576
+ description: This endpoint unlocks a workspace.
2577
+ operationId: unlockWorkspace
2578
+ parameters:
2579
+ - name: workspace_id
2580
+ in: path
2581
+ description: The workspace ID to unlock. Obtain this from the workspace settings or the Show Workspace endpoint.
2582
+ required: true
2583
+ style: simple
2584
+ schema:
2585
+ type: string
2586
+ responses:
2587
+ '200':
2588
+ description: successful operation
2589
+ headers: {}
2590
+ content:
2591
+ text/plain:
2592
+ schema:
2593
+ type: string
2594
+ description: successful operation
2595
+ '400':
2596
+ description: failed operation
2597
+ headers: {}
2598
+ content: {}
2599
+ deprecated: false
2600
+ /workspaces/{workspace_id}/actions/force-unlock:
2601
+ post:
2602
+ tags:
2603
+ - Workspaces
2604
+ summary: forceUnlockWorkspace
2605
+ description: This endpoint force unlocks a workspace. Only users with admin access are authorized to force unlock a workspace.
2606
+ operationId: forceUnlockWorkspace
2607
+ parameters:
2608
+ - name: workspace_id
2609
+ in: path
2610
+ description: The workspace ID to force unlock. Obtain this from the workspace settings or the Show Workspace endpoint.
2611
+ required: true
2612
+ style: simple
2613
+ schema:
2614
+ type: string
2615
+ responses:
2616
+ '200':
2617
+ description: successful operation
2618
+ headers: {}
2619
+ content:
2620
+ text/plain:
2621
+ schema:
2622
+ type: string
2623
+ description: successful operation
2624
+ '400':
2625
+ description: failed operation
2626
+ headers: {}
2627
+ content: {}
2628
+ deprecated: false
2629
+ /workspaces/{workspace_id}/relationships/ssh-key:
2630
+ patch:
2631
+ tags:
2632
+ - Workspaces
2633
+ summary: assignSSHKeyToWorkspace
2634
+ description: This endpoint assigns and unassigns an SSH key to/from a workspace.
2635
+ operationId: assignSSHKeyToWorkspace
2636
+ parameters:
2637
+ - name: workspace_id
2638
+ in: path
2639
+ description: The workspace ID to assign the SSH key to. Obtain this from the workspace settings or the Show Workspace endpoint.
2640
+ required: true
2641
+ style: simple
2642
+ schema:
2643
+ type: string
2644
+ requestBody:
2645
+ description: ''
2646
+ content:
2647
+ text/plain:
2648
+ schema:
2649
+ type: string
2650
+ required: false
2651
+ responses:
2652
+ '200':
2653
+ description: successful operation
2654
+ headers: {}
2655
+ content:
2656
+ text/plain:
2657
+ schema:
2658
+ type: string
2659
+ description: successful operation
2660
+ '400':
2661
+ description: failed operation
2662
+ headers: {}
2663
+ content: {}
2664
+ deprecated: false
2665
+ /workspaces/{workspace_id}/vars:
2666
+ post:
2667
+ tags:
2668
+ - WorkspacesVariables
2669
+ summary: createWorkspaceVariable
2670
+ description: Create a Workspace Variable
2671
+ operationId: createWorkspaceVariable
2672
+ parameters:
2673
+ - name: workspace_id
2674
+ in: path
2675
+ description: The ID of the workspace to create the variable in.
2676
+ required: true
2677
+ style: simple
2678
+ schema:
2679
+ type: string
2680
+ requestBody:
2681
+ description: ''
2682
+ content:
2683
+ text/plain:
2684
+ schema:
2685
+ type: string
2686
+ required: false
2687
+ responses:
2688
+ '200':
2689
+ description: successful operation
2690
+ headers: {}
2691
+ content:
2692
+ text/plain:
2693
+ schema:
2694
+ type: string
2695
+ description: successful operation
2696
+ '400':
2697
+ description: failed operation
2698
+ headers: {}
2699
+ content: {}
2700
+ deprecated: false
2701
+ get:
2702
+ tags:
2703
+ - WorkspacesVariables
2704
+ summary: listWorkspaceVariables
2705
+ description: List workspace variables
2706
+ operationId: listWorkspaceVariables
2707
+ parameters:
2708
+ - name: workspace_id
2709
+ in: path
2710
+ description: The ID of the workspace to list variables for.
2711
+ required: true
2712
+ style: simple
2713
+ schema:
2714
+ type: string
2715
+ responses:
2716
+ '200':
2717
+ description: successful operation
2718
+ headers: {}
2719
+ content:
2720
+ text/plain:
2721
+ schema:
2722
+ type: string
2723
+ description: successful operation
2724
+ '400':
2725
+ description: failed operation
2726
+ headers: {}
2727
+ content: {}
2728
+ deprecated: false
2729
+ /workspaces/{workspace_id}/vars/{variable_id}:
2730
+ patch:
2731
+ tags:
2732
+ - WorkspacesVariables
2733
+ summary: updateWorkspaceVariables
2734
+ description: Update Workspace Variables
2735
+ operationId: updateWorkspaceVariables
2736
+ parameters:
2737
+ - name: workspace_id
2738
+ in: path
2739
+ description: The ID of the workspace that owns the variable.
2740
+ required: true
2741
+ style: simple
2742
+ schema:
2743
+ type: string
2744
+ - name: variable_id
2745
+ in: path
2746
+ description: The ID of the variable to be updated.
2747
+ required: true
2748
+ style: simple
2749
+ schema:
2750
+ type: string
2751
+ requestBody:
2752
+ description: ''
2753
+ content:
2754
+ text/plain:
2755
+ schema:
2756
+ type: string
2757
+ required: false
2758
+ responses:
2759
+ '200':
2760
+ description: successful operation
2761
+ headers: {}
2762
+ content:
2763
+ text/plain:
2764
+ schema:
2765
+ type: string
2766
+ description: successful operation
2767
+ '400':
2768
+ description: failed operation
2769
+ headers: {}
2770
+ content: {}
2771
+ deprecated: false
2772
+ delete:
2773
+ tags:
2774
+ - WorkspacesVariables
2775
+ summary: deleteWorkspaceVariables
2776
+ description: Delete Workspace Variables
2777
+ operationId: deleteWorkspaceVariables
2778
+ parameters:
2779
+ - name: workspace_id
2780
+ in: path
2781
+ description: The ID of the workspace that owns the variable.
2782
+ required: true
2783
+ style: simple
2784
+ schema:
2785
+ type: string
2786
+ - name: variable_id
2787
+ in: path
2788
+ description: The ID of the variable to be deleted.
2789
+ required: true
2790
+ style: simple
2791
+ schema:
2792
+ type: string
2793
+ responses:
2794
+ '200':
2795
+ description: successful operation
2796
+ headers: {}
2797
+ content:
2798
+ text/plain:
2799
+ schema:
2800
+ type: string
2801
+ description: successful operation
2802
+ '400':
2803
+ description: failed operation
2804
+ headers: {}
2805
+ content: {}
2806
+ deprecated: false
2807
+ tags:
2808
+ - name: default
2809
+ description: ''
2810
+ externalDocs:
2811
+ url: http://swagger.io
2812
+ - name: Account
2813
+ description: Account represents the current user interacting with Terraform. It returns the same type of object as the Users API, but also includes an email address, which is hidden when viewing info about other users.
2814
+ - name: Applies
2815
+ description: An apply represents the results of applying a Terraform Run's execution plan.
2816
+ - name: CostEstimates
2817
+ description: Cost estimate Information
2818
+ - name: NotificationConfigurations
2819
+ description: Terraform Cloud can be configured to send notifications for run state transitions. The configuration allows you to specify a destination URL, request type, and what events will trigger the notification. Each workspace can have up to 20 notification configurations, and they apply to all runs for that workspace.
2820
+ - name: OAuthClients
2821
+ description: An OAuth Client represents the connection between an organization and a VCS provider.
2822
+ - name: OAuthTokens
2823
+ description: The oauth-token object represents a VCS configuration which includes the OAuth connection and the associated OAuth token. This object is used when creating a workspace to identify which VCS connection to use.
2824
+ - name: Organizations
2825
+ description: The Organizations API is used to list, show, create, update, and destroy organizations.
2826
+ - name: OrganizationMemberships
2827
+ description: >-
2828
+ Users are added to organizations by inviting them to join. Once accepted, they become members of the organization. The Organization Membership resource represents this membership.
2829
+
2830
+ You can invite users who already have an account, as well as new users. If the user has an existing account with the same email address used to invite them, they can reuse the same login.
2831
+ - name: OrganizationToken
2832
+ description: Organization Token API
2833
+ - name: PlanExports
2834
+ description: Plan exports allow users to download data exported from the plan of a Run in a Terraform workspace. Currently, the only supported format for exporting plan data is to generate mock data for Sentinel.
2835
+ - name: Plans
2836
+ description: Plan exports allow users to download data exported from the plan of a Run in a Terraform workspace.
2837
+ - name: Policies
2838
+ description: Policies are configured on a per-organization level and are organized and grouped into policy sets, which define the workspaces on which policies are enforced during runs. In these workspaces, the plan's changes are validated against the relevant policies after the plan step.
2839
+ - name: PolicyChecks
2840
+ description: Policy Checks.
2841
+ - name: PolicySets
2842
+ description: Policy Sets.
2843
+ - name: PolicySetParameters
2844
+ description: Policy Set Parameters.
2845
+ - name: Runs
2846
+ description: Performing a run on a new configuration is a multi-step process. Create a configuration version on the workspace. Upload configuration files to the configuration version. Create a run on the workspace; this is done automatically when a configuration file is uploaded. Create and queue an apply on the run; if the run can't be auto-applied. Alternatively, you can create a run with a pre-existing configuration version, even one from another workspace. This is useful for promoting known good code from one workspace to another.
2847
+ - name: StateVersions
2848
+ description: State Versions.
2849
+ - name: StateVersionOutputs
2850
+ description: State Version Outputs.
2851
+ - name: Users
2852
+ description: Terraform Cloud's user objects do not contain any identifying information about a user, other than their Terraform Cloud username and avatar image; they are intended for displaying names and avatars in contexts that refer to a user by ID, like lists of team members or the details of a run. Most of these contexts can already include user objects via an ?include parameter, so you shouldn't usually need to make a separate call to this endpoint.
2853
+ - name: Variables
2854
+ description: This set of APIs covers create, update, list and delete operations on variables.
2855
+ - name: Workspaces
2856
+ description: Workspaces represent running infrastructure managed by Terraform.
2857
+ - name: WorkspacesVariables
2858
+ description: This set of APIs covers create, update, list and delete operations on workspace variables
2859
+ externalDocs:
2860
+ description: Find out more about Swagger
2861
+ url: http://swagger.io