@opusdns/api 1.5.0 → 1.6.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 (2) hide show
  1. package/package.json +1 -1
  2. package/src/openapi.yaml +246 -1
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "@opusdns/api-spec-ts-generator": "^1.2.0"
4
4
  },
5
5
  "name": "@opusdns/api",
6
- "version": "1.5.0",
6
+ "version": "1.6.0",
7
7
  "description": "TypeScript types for the OpusDNS OpenAPI specification",
8
8
  "main": "./src/index.ts",
9
9
  "module": "./src/index.ts",
package/src/openapi.yaml CHANGED
@@ -11537,7 +11537,7 @@ info:
11537
11537
  \n\n"
11538
11538
  summary: OpusDNS - your gateway to a seamless domain management experience.
11539
11539
  title: OpusDNS API
11540
- version: 2026-06-10-074321
11540
+ version: 2026-06-10-075045
11541
11541
  x-logo:
11542
11542
  altText: OpusDNS API Reference
11543
11543
  url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -12817,6 +12817,8 @@ paths:
12817
12817
  summary: Retrieve email forward logs by alias
12818
12818
  tags:
12819
12819
  - archive
12820
+ x-required-permissions:
12821
+ - email_forwards:read
12820
12822
  /v1/archive/email-forward-logs/{email_forward_id}:
12821
12823
  get:
12822
12824
  description: Retrieves a paginated list of email forward logs for a specific
@@ -12908,6 +12910,8 @@ paths:
12908
12910
  summary: Retrieve email forward logs
12909
12911
  tags:
12910
12912
  - archive
12913
+ x-required-permissions:
12914
+ - email_forwards:read
12911
12915
  /v1/archive/object-logs:
12912
12916
  get:
12913
12917
  description: Retrieve all paginated audit logs with optional filtering and sorting
@@ -13708,6 +13712,8 @@ paths:
13708
13712
  summary: List all contacts
13709
13713
  tags:
13710
13714
  - contact
13715
+ x-required-permissions:
13716
+ - contacts:read
13711
13717
  post:
13712
13718
  description: Create a new contact object to use for domain registration
13713
13719
  operationId: create_contact_v1_contacts_post
@@ -13736,6 +13742,8 @@ paths:
13736
13742
  summary: Create a contact
13737
13743
  tags:
13738
13744
  - contact
13745
+ x-required-permissions:
13746
+ - contacts:manage
13739
13747
  /v1/contacts/attribute-sets:
13740
13748
  get:
13741
13749
  operationId: list_attribute_sets_v1_contacts_attribute_sets_get
@@ -13804,6 +13812,8 @@ paths:
13804
13812
  summary: List contact attribute sets
13805
13813
  tags:
13806
13814
  - contact
13815
+ x-required-permissions:
13816
+ - contacts:read
13807
13817
  post:
13808
13818
  operationId: create_attribute_set_v1_contacts_attribute_sets_post
13809
13819
  requestBody:
@@ -13845,6 +13855,8 @@ paths:
13845
13855
  summary: Create a contact attribute set
13846
13856
  tags:
13847
13857
  - contact
13858
+ x-required-permissions:
13859
+ - contacts:manage
13848
13860
  /v1/contacts/attribute-sets/{contact_attribute_set_id}:
13849
13861
  delete:
13850
13862
  operationId: delete_attribute_set_v1_contacts_attribute_sets__contact_attribute_set_id__delete
@@ -13888,6 +13900,8 @@ paths:
13888
13900
  summary: Delete a contact attribute set
13889
13901
  tags:
13890
13902
  - contact
13903
+ x-required-permissions:
13904
+ - contacts:manage
13891
13905
  get:
13892
13906
  operationId: get_attribute_set_v1_contacts_attribute_sets__contact_attribute_set_id__get
13893
13907
  parameters:
@@ -13934,6 +13948,8 @@ paths:
13934
13948
  summary: Retrieve a contact attribute set
13935
13949
  tags:
13936
13950
  - contact
13951
+ x-required-permissions:
13952
+ - contacts:read
13937
13953
  patch:
13938
13954
  operationId: update_attribute_set_v1_contacts_attribute_sets__contact_attribute_set_id__patch
13939
13955
  parameters:
@@ -14000,6 +14016,8 @@ paths:
14000
14016
  summary: Update a contact attribute set
14001
14017
  tags:
14002
14018
  - contact
14019
+ x-required-permissions:
14020
+ - contacts:manage
14003
14021
  /v1/contacts/verification:
14004
14022
  get:
14005
14023
  operationId: get_verification_by_token_v1_contacts_verification_get
@@ -14194,6 +14212,8 @@ paths:
14194
14212
  summary: Delete a contact
14195
14213
  tags:
14196
14214
  - contact
14215
+ x-required-permissions:
14216
+ - contacts:delete
14197
14217
  get:
14198
14218
  operationId: get_contact_v1_contacts__contact_id__get
14199
14219
  parameters:
@@ -14250,6 +14270,8 @@ paths:
14250
14270
  summary: Retrieve a contact
14251
14271
  tags:
14252
14272
  - contact
14273
+ x-required-permissions:
14274
+ - contacts:read
14253
14275
  /v1/contacts/{contact_id}/link/{contact_attribute_set_id}:
14254
14276
  patch:
14255
14277
  operationId: create_attribute_link_v1_contacts__contact_id__link__contact_attribute_set_id__patch
@@ -14333,6 +14355,8 @@ paths:
14333
14355
  summary: Link a contact to a contact attribute set
14334
14356
  tags:
14335
14357
  - contact
14358
+ x-required-permissions:
14359
+ - contacts:manage
14336
14360
  /v1/contacts/{contact_id}/verification:
14337
14361
  delete:
14338
14362
  operationId: cancel_verification_v1_contacts__contact_id__verification_delete
@@ -14388,6 +14412,8 @@ paths:
14388
14412
  summary: Delete contact verification
14389
14413
  tags:
14390
14414
  - contact
14415
+ x-required-permissions:
14416
+ - contacts:manage
14391
14417
  get:
14392
14418
  operationId: get_verification_status_v1_contacts__contact_id__verification_get
14393
14419
  parameters:
@@ -14446,6 +14472,8 @@ paths:
14446
14472
  summary: Retrieve contact verification by contact ID
14447
14473
  tags:
14448
14474
  - contact
14475
+ x-required-permissions:
14476
+ - contacts:manage
14449
14477
  post:
14450
14478
  operationId: start_contact_verification_v1_contacts__contact_id__verification_post
14451
14479
  parameters:
@@ -14525,6 +14553,8 @@ paths:
14525
14553
  summary: Start contact verification
14526
14554
  tags:
14527
14555
  - contact
14556
+ x-required-permissions:
14557
+ - contacts:manage
14528
14558
  put:
14529
14559
  operationId: update_verification_v1_contacts__contact_id__verification_put
14530
14560
  parameters:
@@ -14613,6 +14643,8 @@ paths:
14613
14643
  summary: Complete contact verification by contact ID
14614
14644
  tags:
14615
14645
  - contact
14646
+ x-required-permissions:
14647
+ - contacts:manage
14616
14648
  /v1/contacts/{contact_id}/verifications:
14617
14649
  get:
14618
14650
  description: Retrieve the current verification state for a contact from the
@@ -14686,6 +14718,8 @@ paths:
14686
14718
  summary: Get contact verification status
14687
14719
  tags:
14688
14720
  - contact
14721
+ x-required-permissions:
14722
+ - contacts:read
14689
14723
  /v1/contacts/{contact_id}/verifications/attest:
14690
14724
  post:
14691
14725
  description: Submit one or more contact-verification attestations. Returns the
@@ -14780,6 +14814,8 @@ paths:
14780
14814
  summary: Attest a contact verification
14781
14815
  tags:
14782
14816
  - contact
14817
+ x-required-permissions:
14818
+ - contacts:manage
14783
14819
  /v1/dns:
14784
14820
  get:
14785
14821
  operationId: list_zones_v1_dns_get
@@ -14977,6 +15013,8 @@ paths:
14977
15013
  summary: List Zones
14978
15014
  tags:
14979
15015
  - dns
15016
+ x-required-permissions:
15017
+ - dns:read
14980
15018
  post:
14981
15019
  operationId: create_zone_v1_dns_post
14982
15020
  requestBody:
@@ -15231,6 +15269,8 @@ paths:
15231
15269
  summary: Create Zone
15232
15270
  tags:
15233
15271
  - dns
15272
+ x-required-permissions:
15273
+ - dns:manage
15234
15274
  /v1/dns/domain-forwards:
15235
15275
  get:
15236
15276
  description: Retrieves a paginated list of domain forwards grouped by DNS zones.
@@ -15350,6 +15390,8 @@ paths:
15350
15390
  summary: List domain forwards by zone
15351
15391
  tags:
15352
15392
  - dns
15393
+ x-required-permissions:
15394
+ - dns:read
15353
15395
  /v1/dns/email-forwards:
15354
15396
  get:
15355
15397
  description: Retrieves a paginated list of email forwards grouped by DNS zones.
@@ -15435,6 +15477,8 @@ paths:
15435
15477
  summary: List email forwards by zone
15436
15478
  tags:
15437
15479
  - dns
15480
+ x-required-permissions:
15481
+ - dns:read
15438
15482
  /v1/dns/summary:
15439
15483
  get:
15440
15484
  operationId: get_zones_summary_v1_dns_summary_get
@@ -15466,6 +15510,8 @@ paths:
15466
15510
  summary: Get Zones Summary
15467
15511
  tags:
15468
15512
  - dns
15513
+ x-required-permissions:
15514
+ - dns:read
15469
15515
  /v1/dns/{zone_name}:
15470
15516
  delete:
15471
15517
  operationId: delete_zone_v1_dns__zone_name__delete
@@ -15493,6 +15539,8 @@ paths:
15493
15539
  summary: Delete Zone
15494
15540
  tags:
15495
15541
  - dns
15542
+ x-required-permissions:
15543
+ - dns:delete
15496
15544
  get:
15497
15545
  operationId: get_zone_v1_dns__zone_name__get
15498
15546
  parameters:
@@ -15533,6 +15581,8 @@ paths:
15533
15581
  summary: Get Zone
15534
15582
  tags:
15535
15583
  - dns
15584
+ x-required-permissions:
15585
+ - dns:read
15536
15586
  /v1/dns/{zone_name}/dnssec/disable:
15537
15587
  post:
15538
15588
  operationId: disable_dnssec_v1_dns__zone_name__dnssec_disable_post
@@ -15619,6 +15669,8 @@ paths:
15619
15669
  summary: Disable Dnssec
15620
15670
  tags:
15621
15671
  - dns
15672
+ x-required-permissions:
15673
+ - dns:manage
15622
15674
  /v1/dns/{zone_name}/dnssec/enable:
15623
15675
  post:
15624
15676
  operationId: enable_dnssec_v1_dns__zone_name__dnssec_enable_post
@@ -15705,6 +15757,8 @@ paths:
15705
15757
  summary: Enable Dnssec
15706
15758
  tags:
15707
15759
  - dns
15760
+ x-required-permissions:
15761
+ - dns:manage
15708
15762
  /v1/dns/{zone_name}/domain-forwards:
15709
15763
  get:
15710
15764
  description: Retrieves all domain forwards configured for the specified DNS
@@ -15788,6 +15842,8 @@ paths:
15788
15842
  summary: List domain forwards for a zone
15789
15843
  tags:
15790
15844
  - dns
15845
+ x-required-permissions:
15846
+ - dns:read
15791
15847
  /v1/dns/{zone_name}/email-forwards:
15792
15848
  get:
15793
15849
  description: Retrieves all email forwards configured for the specified DNS zone,
@@ -15845,6 +15901,8 @@ paths:
15845
15901
  summary: List email forwards for a zone
15846
15902
  tags:
15847
15903
  - dns
15904
+ x-required-permissions:
15905
+ - dns:read
15848
15906
  /v1/dns/{zone_name}/records:
15849
15907
  patch:
15850
15908
  operationId: patch_zone_records_v1_dns__zone_name__records_patch
@@ -15944,6 +16002,8 @@ paths:
15944
16002
  summary: Patch Zone Records
15945
16003
  tags:
15946
16004
  - dns
16005
+ x-required-permissions:
16006
+ - dns:manage
15947
16007
  /v1/dns/{zone_name}/rrsets:
15948
16008
  patch:
15949
16009
  operationId: patch_zone_rrsets_v1_dns__zone_name__rrsets_patch
@@ -16089,6 +16149,8 @@ paths:
16089
16149
  summary: Patch Zone Rrsets
16090
16150
  tags:
16091
16151
  - dns
16152
+ x-required-permissions:
16153
+ - dns:manage
16092
16154
  put:
16093
16155
  operationId: update_zone_rrsets_v1_dns__zone_name__rrsets_put
16094
16156
  parameters:
@@ -16221,6 +16283,8 @@ paths:
16221
16283
  summary: Update Zone Rrsets
16222
16284
  tags:
16223
16285
  - dns
16286
+ x-required-permissions:
16287
+ - dns:manage
16224
16288
  /v1/domain-forwards:
16225
16289
  get:
16226
16290
  description: Retrieves a paginated list of domain forwards by hostname for the
@@ -16404,6 +16468,8 @@ paths:
16404
16468
  summary: List domain forwards
16405
16469
  tags:
16406
16470
  - domain_forward
16471
+ x-required-permissions:
16472
+ - domain_forwards:read
16407
16473
  patch:
16408
16474
  description: Applies patch operations to update or remove redirects across hostnames
16409
16475
  and protocols. Raises an error if the domain forward or domain forward set
@@ -16466,6 +16532,8 @@ paths:
16466
16532
  summary: Patch domain forward redirects
16467
16533
  tags:
16468
16534
  - domain_forward
16535
+ x-required-permissions:
16536
+ - domain_forwards:manage
16469
16537
  post:
16470
16538
  description: Creates a new domain forward configuration. Wildcard forwards can
16471
16539
  be created by using *.hostname (e.g., *.example.com).
@@ -16641,6 +16709,8 @@ paths:
16641
16709
  summary: Create a domain forward
16642
16710
  tags:
16643
16711
  - domain_forward
16712
+ x-required-permissions:
16713
+ - domain_forwards:manage
16644
16714
  /v1/domain-forwards/metrics:
16645
16715
  get:
16646
16716
  description: Retrieves overall metrics for domain forwards including total and
@@ -16759,6 +16829,8 @@ paths:
16759
16829
  summary: Get domain forward metrics
16760
16830
  tags:
16761
16831
  - domain_forward
16832
+ x-required-permissions:
16833
+ - domain_forwards:read
16762
16834
  /v1/domain-forwards/metrics/browser:
16763
16835
  get:
16764
16836
  description: Retrieves visitor traffic broken down by browser type (Chrome,
@@ -16900,6 +16972,8 @@ paths:
16900
16972
  summary: Get browser statistics
16901
16973
  tags:
16902
16974
  - domain_forward
16975
+ x-required-permissions:
16976
+ - domain_forwards:read
16903
16977
  /v1/domain-forwards/metrics/geo:
16904
16978
  get:
16905
16979
  description: Retrieves visitor traffic broken down by geographic location (country
@@ -17034,6 +17108,8 @@ paths:
17034
17108
  summary: Get geographic statistics
17035
17109
  tags:
17036
17110
  - domain_forward
17111
+ x-required-permissions:
17112
+ - domain_forwards:read
17037
17113
  /v1/domain-forwards/metrics/platform:
17038
17114
  get:
17039
17115
  description: Retrieves visitor traffic broken down by platform (Windows, Macintosh,
@@ -17173,6 +17249,8 @@ paths:
17173
17249
  summary: Get platform statistics
17174
17250
  tags:
17175
17251
  - domain_forward
17252
+ x-required-permissions:
17253
+ - domain_forwards:read
17176
17254
  /v1/domain-forwards/metrics/referrer:
17177
17255
  get:
17178
17256
  description: Retrieves visitor referral sources (where traffic came from) with
@@ -17314,6 +17392,8 @@ paths:
17314
17392
  summary: Get referrer statistics
17315
17393
  tags:
17316
17394
  - domain_forward
17395
+ x-required-permissions:
17396
+ - domain_forwards:read
17317
17397
  /v1/domain-forwards/metrics/status-code:
17318
17398
  get:
17319
17399
  description: Retrieves distribution of HTTP redirect status codes (301, 302,
@@ -17441,6 +17521,8 @@ paths:
17441
17521
  summary: Get HTTP status code statistics
17442
17522
  tags:
17443
17523
  - domain_forward
17524
+ x-required-permissions:
17525
+ - domain_forwards:read
17444
17526
  /v1/domain-forwards/metrics/time-series:
17445
17527
  get:
17446
17528
  description: Retrieves visit counts bucketed by time intervals (hourly, daily)
@@ -17614,6 +17696,8 @@ paths:
17614
17696
  summary: Get domain forward time series metrics
17615
17697
  tags:
17616
17698
  - domain_forward
17699
+ x-required-permissions:
17700
+ - domain_forwards:read
17617
17701
  /v1/domain-forwards/metrics/user-agent:
17618
17702
  get:
17619
17703
  description: Retrieves visitor traffic broken down by user agent string with
@@ -17747,6 +17831,8 @@ paths:
17747
17831
  summary: Get user agent statistics
17748
17832
  tags:
17749
17833
  - domain_forward
17834
+ x-required-permissions:
17835
+ - domain_forwards:read
17750
17836
  /v1/domain-forwards/metrics/visits-by-key:
17751
17837
  get:
17752
17838
  description: Retrieves visit metrics grouped by a specified key (url, fqdn,
@@ -17901,6 +17987,8 @@ paths:
17901
17987
  summary: Get visits grouped by key
17902
17988
  tags:
17903
17989
  - domain_forward
17990
+ x-required-permissions:
17991
+ - domain_forwards:read
17904
17992
  /v1/domain-forwards/{hostname}:
17905
17993
  delete:
17906
17994
  description: Deletes the domain forward configuration for the specified hostname
@@ -17965,6 +18053,8 @@ paths:
17965
18053
  summary: Delete a domain forward
17966
18054
  tags:
17967
18055
  - domain_forward
18056
+ x-required-permissions:
18057
+ - domain_forwards:delete
17968
18058
  get:
17969
18059
  description: Retrieves the domain forward configuration for the specified hostname
17970
18060
  operationId: get_domain_forward_v1_domain_forwards__hostname__get
@@ -18067,6 +18157,8 @@ paths:
18067
18157
  summary: Get a domain forward
18068
18158
  tags:
18069
18159
  - domain_forward
18160
+ x-required-permissions:
18161
+ - domain_forwards:read
18070
18162
  post:
18071
18163
  description: Creates a new domain forward set for a specific protocol (HTTP
18072
18164
  or HTTPS). Raises an error if the set already exists.
@@ -18171,6 +18263,8 @@ paths:
18171
18263
  summary: Create domain forward set
18172
18264
  tags:
18173
18265
  - domain_forward
18266
+ x-required-permissions:
18267
+ - domain_forwards:manage
18174
18268
  /v1/domain-forwards/{hostname}/disable:
18175
18269
  patch:
18176
18270
  description: Disables domain forwarding by removing DNS records. The domain
@@ -18225,6 +18319,8 @@ paths:
18225
18319
  summary: Disable domain forward
18226
18320
  tags:
18227
18321
  - domain_forward
18322
+ x-required-permissions:
18323
+ - domain_forwards:manage
18228
18324
  /v1/domain-forwards/{hostname}/enable:
18229
18325
  patch:
18230
18326
  description: Enables domain forwarding by creating necessary DNS records
@@ -18278,6 +18374,8 @@ paths:
18278
18374
  summary: Enable domain forward
18279
18375
  tags:
18280
18376
  - domain_forward
18377
+ x-required-permissions:
18378
+ - domain_forwards:manage
18281
18379
  /v1/domain-forwards/{hostname}/{protocol}:
18282
18380
  delete:
18283
18381
  description: Deletes a domain forward set for a specific protocol (HTTP or HTTPS).
@@ -18348,6 +18446,8 @@ paths:
18348
18446
  summary: Delete domain forward set
18349
18447
  tags:
18350
18448
  - domain_forward
18449
+ x-required-permissions:
18450
+ - domain_forwards:delete
18351
18451
  get:
18352
18452
  description: Retrieves all redirects for a specific protocol (HTTP or HTTPS)
18353
18453
  for the specified hostname
@@ -18456,6 +18556,8 @@ paths:
18456
18556
  summary: Get domain forward set
18457
18557
  tags:
18458
18558
  - domain_forward
18559
+ x-required-permissions:
18560
+ - domain_forwards:read
18459
18561
  put:
18460
18562
  description: Updates an existing domain forward set for a specific protocol
18461
18563
  (HTTP or HTTPS). All existing redirects for this protocol are replaced with
@@ -18555,6 +18657,8 @@ paths:
18555
18657
  summary: Update domain forward set
18556
18658
  tags:
18557
18659
  - domain_forward
18660
+ x-required-permissions:
18661
+ - domain_forwards:manage
18558
18662
  /v1/domain-search/suggest:
18559
18663
  get:
18560
18664
  description: Get a list of domain suggestions based on a search query
@@ -18918,6 +19022,8 @@ paths:
18918
19022
  summary: List all domains
18919
19023
  tags:
18920
19024
  - domain
19025
+ x-required-permissions:
19026
+ - domains:read
18921
19027
  post:
18922
19028
  description: 'Registers a new domain.
18923
19029
 
@@ -19035,6 +19141,8 @@ paths:
19035
19141
  summary: Create a domain
19036
19142
  tags:
19037
19143
  - domain
19144
+ x-required-permissions:
19145
+ - domains:manage
19038
19146
  /v1/domains/check:
19039
19147
  get:
19040
19148
  description: 'Performs a real-time check against the authoritative registry
@@ -19122,6 +19230,8 @@ paths:
19122
19230
  summary: Check domain availability and registration metadata
19123
19231
  tags:
19124
19232
  - domain
19233
+ x-required-permissions:
19234
+ - domains:read
19125
19235
  /v1/domains/claims-notices:
19126
19236
  post:
19127
19237
  description: Retrieves the trademark claims notice for a `claims_key` returned
@@ -19181,6 +19291,8 @@ paths:
19181
19291
  summary: Retrieve claims notices from claim keys
19182
19292
  tags:
19183
19293
  - domain
19294
+ x-required-permissions:
19295
+ - domains:manage
19184
19296
  /v1/domains/summary:
19185
19297
  get:
19186
19298
  description: Retrieves a summary of domains including counts by status, TLD,
@@ -19205,6 +19317,8 @@ paths:
19205
19317
  summary: Get domain summary
19206
19318
  tags:
19207
19319
  - domain
19320
+ x-required-permissions:
19321
+ - domains:read
19208
19322
  /v1/domains/tld-specific/at/{domain_reference}/withdraw:
19209
19323
  post:
19210
19324
  operationId: withdraw_domain_v1_domains_tld_specific_at__domain_reference__withdraw_post
@@ -19261,6 +19375,8 @@ paths:
19261
19375
  tags:
19262
19376
  - domain
19263
19377
  - domain_tld_specific
19378
+ x-required-permissions:
19379
+ - domains:manage
19264
19380
  /v1/domains/tld-specific/be/{domain_reference}/auth_code/request:
19265
19381
  post:
19266
19382
  operationId: request_auth_code_v1_domains_tld_specific_be__domain_reference__auth_code_request_post
@@ -19325,6 +19441,8 @@ paths:
19325
19441
  tags:
19326
19442
  - domain
19327
19443
  - domain_tld_specific
19444
+ x-required-permissions:
19445
+ - domains:manage
19328
19446
  /v1/domains/tld-specific/de/{domain_reference}/transit:
19329
19447
  post:
19330
19448
  operationId: transit_domain_v1_domains_tld_specific_de__domain_reference__transit_post
@@ -19381,6 +19499,8 @@ paths:
19381
19499
  tags:
19382
19500
  - domain
19383
19501
  - domain_tld_specific
19502
+ x-required-permissions:
19503
+ - domains:manage
19384
19504
  /v1/domains/tld-specific/eu/{domain_reference}/auth_code/request:
19385
19505
  post:
19386
19506
  operationId: request_auth_code_v1_domains_tld_specific_eu__domain_reference__auth_code_request_post
@@ -19445,6 +19565,8 @@ paths:
19445
19565
  tags:
19446
19566
  - domain
19447
19567
  - domain_tld_specific
19568
+ x-required-permissions:
19569
+ - domains:manage
19448
19570
  /v1/domains/transfer:
19449
19571
  post:
19450
19572
  description: 'Start the transfer process for a domain <br>
@@ -19588,6 +19710,8 @@ paths:
19588
19710
  summary: Transfer a domain
19589
19711
  tags:
19590
19712
  - domain
19713
+ x-required-permissions:
19714
+ - domains:manage
19591
19715
  /v1/domains/{domain_reference}:
19592
19716
  delete:
19593
19717
  description: 'Initiates the deletion process for a domain. The domain will be
@@ -19651,6 +19775,8 @@ paths:
19651
19775
  summary: Delete a domain
19652
19776
  tags:
19653
19777
  - domain
19778
+ x-required-permissions:
19779
+ - domains:delete
19654
19780
  get:
19655
19781
  description: Retrieves a single active domain by either its name or id
19656
19782
  operationId: get_domain_v1_domains__domain_reference__get
@@ -19712,6 +19838,8 @@ paths:
19712
19838
  summary: Retrieve a domain
19713
19839
  tags:
19714
19840
  - domain
19841
+ x-required-permissions:
19842
+ - domains:read
19715
19843
  patch:
19716
19844
  description: 'Updates various attributes of an existing domain. Only the fields
19717
19845
  provided in the request
@@ -19783,6 +19911,8 @@ paths:
19783
19911
  summary: Update a domain
19784
19912
  tags:
19785
19913
  - domain
19914
+ x-required-permissions:
19915
+ - domains:manage
19786
19916
  /v1/domains/{domain_reference}/dnssec:
19787
19917
  delete:
19788
19918
  description: Removes all DNSSEC data for a domain
@@ -19829,6 +19959,8 @@ paths:
19829
19959
  summary: Delete DNSSEC data
19830
19960
  tags:
19831
19961
  - domain
19962
+ x-required-permissions:
19963
+ - domains:manage
19832
19964
  get:
19833
19965
  description: Fetches all DNSSEC records associated with the specified domain.
19834
19966
  operationId: get_dnssec_v1_domains__domain_reference__dnssec_get
@@ -19881,6 +20013,8 @@ paths:
19881
20013
  summary: Retrieve DNSSEC data
19882
20014
  tags:
19883
20015
  - domain
20016
+ x-required-permissions:
20017
+ - domains:read
19884
20018
  put:
19885
20019
  description: Replaces all existing DNSSEC records for the domain with the provided
19886
20020
  records.
@@ -19950,6 +20084,8 @@ paths:
19950
20084
  summary: Update DNSSEC data
19951
20085
  tags:
19952
20086
  - domain
20087
+ x-required-permissions:
20088
+ - domains:manage
19953
20089
  /v1/domains/{domain_reference}/dnssec/disable:
19954
20090
  post:
19955
20091
  operationId: disable_and_unpublish_dnssec_records_v1_domains__domain_reference__dnssec_disable_post
@@ -19995,6 +20131,8 @@ paths:
19995
20131
  summary: Disable DNSSEC for domains using our nameservers
19996
20132
  tags:
19997
20133
  - domain
20134
+ x-required-permissions:
20135
+ - domains:manage
19998
20136
  /v1/domains/{domain_reference}/dnssec/enable:
19999
20137
  post:
20000
20138
  operationId: enable_and_publish_dnssec_records_v1_domains__domain_reference__dnssec_enable_post
@@ -20048,6 +20186,8 @@ paths:
20048
20186
  summary: Enable DNSSEC for domains using our nameservers
20049
20187
  tags:
20050
20188
  - domain
20189
+ x-required-permissions:
20190
+ - domains:manage
20051
20191
  /v1/domains/{domain_reference}/renew:
20052
20192
  post:
20053
20193
  description: 'Extends the registration period of an existing domain. The renewal
@@ -20094,6 +20234,8 @@ paths:
20094
20234
  summary: Renew a domain
20095
20235
  tags:
20096
20236
  - domain
20237
+ x-required-permissions:
20238
+ - domains:manage
20097
20239
  /v1/domains/{domain_reference}/restore:
20098
20240
  post:
20099
20241
  operationId: restore_domain_v1_domains__domain_reference__restore_post
@@ -20136,6 +20278,8 @@ paths:
20136
20278
  summary: Restore an eligible domain (during redemption period)
20137
20279
  tags:
20138
20280
  - domain
20281
+ x-required-permissions:
20282
+ - domains:manage
20139
20283
  /v1/domains/{domain_reference}/transfer:
20140
20284
  delete:
20141
20285
  description: This will cancel the in-progress domain transfer and delete the
@@ -20197,6 +20341,8 @@ paths:
20197
20341
  summary: Cancel a domain transfer
20198
20342
  tags:
20199
20343
  - domain
20344
+ x-required-permissions:
20345
+ - domains:manage
20200
20346
  /v1/email-forwards:
20201
20347
  get:
20202
20348
  description: Retrieves a paginated list of all email forwards for the organization.
@@ -20290,6 +20436,8 @@ paths:
20290
20436
  summary: List all email forwards
20291
20437
  tags:
20292
20438
  - email_forward
20439
+ x-required-permissions:
20440
+ - email_forwards:read
20293
20441
  post:
20294
20442
  description: 'Creates an email forward configuration with optional aliases.
20295
20443
  Can be created enabled or disabled (default: disabled). Includes created_on
@@ -20431,6 +20579,9 @@ paths:
20431
20579
  summary: Create email forward configuration
20432
20580
  tags:
20433
20581
  - email_forward
20582
+ x-required-permissions:
20583
+ - dns:manage
20584
+ - email_forwards:manage
20434
20585
  /v1/email-forwards/{email_forward_id}:
20435
20586
  delete:
20436
20587
  description: Permanently deletes the email forward configuration including all
@@ -20488,6 +20639,8 @@ paths:
20488
20639
  summary: Delete email forward configuration
20489
20640
  tags:
20490
20641
  - email_forward
20642
+ x-required-permissions:
20643
+ - email_forwards:delete
20491
20644
  get:
20492
20645
  description: Retrieves the email forward configuration for the specified email
20493
20646
  forward including all aliases
@@ -20559,6 +20712,8 @@ paths:
20559
20712
  summary: Get email forward configuration
20560
20713
  tags:
20561
20714
  - email_forward
20715
+ x-required-permissions:
20716
+ - email_forwards:read
20562
20717
  /v1/email-forwards/{email_forward_id}/aliases:
20563
20718
  post:
20564
20719
  description: Creates a new email forward alias for the specified email forward.
@@ -20684,6 +20839,8 @@ paths:
20684
20839
  summary: Create email forward alias
20685
20840
  tags:
20686
20841
  - email_forward
20842
+ x-required-permissions:
20843
+ - email_forwards:manage
20687
20844
  /v1/email-forwards/{email_forward_id}/aliases/{alias_id}:
20688
20845
  delete:
20689
20846
  description: Deletes a specific email forward alias specified by email_forward_alias_id
@@ -20764,6 +20921,8 @@ paths:
20764
20921
  summary: Delete email forward alias
20765
20922
  tags:
20766
20923
  - email_forward
20924
+ x-required-permissions:
20925
+ - email_forwards:manage
20767
20926
  put:
20768
20927
  description: Updates the forward_to address for a specific email forward alias
20769
20928
  specified by email_forward_alias_id
@@ -20853,6 +21012,8 @@ paths:
20853
21012
  summary: Update email forward alias
20854
21013
  tags:
20855
21014
  - email_forward
21015
+ x-required-permissions:
21016
+ - email_forwards:manage
20856
21017
  /v1/email-forwards/{email_forward_id}/disable:
20857
21018
  patch:
20858
21019
  description: Disables email forwarding by removing MX and SPF DNS records and
@@ -20922,6 +21083,8 @@ paths:
20922
21083
  summary: Disable email forwarding
20923
21084
  tags:
20924
21085
  - email_forward
21086
+ x-required-permissions:
21087
+ - email_forwards:manage
20925
21088
  /v1/email-forwards/{email_forward_id}/enable:
20926
21089
  patch:
20927
21090
  description: Enables email forwarding by creating necessary MX and SPF DNS records
@@ -20990,6 +21153,8 @@ paths:
20990
21153
  summary: Enable email forwarding
20991
21154
  tags:
20992
21155
  - email_forward
21156
+ x-required-permissions:
21157
+ - email_forwards:manage
20993
21158
  /v1/email-forwards/{email_forward_id}/metrics:
20994
21159
  get:
20995
21160
  description: Retrieves metrics and statistics for a specific email forward,
@@ -21080,6 +21245,8 @@ paths:
21080
21245
  summary: Retrieve email forward metrics
21081
21246
  tags:
21082
21247
  - email_forward
21248
+ x-required-permissions:
21249
+ - email_forwards:read
21083
21250
  /v1/events:
21084
21251
  get:
21085
21252
  description: Retrieves a paginated list of events for the organization
@@ -21186,6 +21353,8 @@ paths:
21186
21353
  summary: Get pending events
21187
21354
  tags:
21188
21355
  - event
21356
+ x-required-permissions:
21357
+ - events:read
21189
21358
  /v1/events/{event_id}:
21190
21359
  get:
21191
21360
  description: Get an event by its ID
@@ -21246,6 +21415,8 @@ paths:
21246
21415
  summary: Get event
21247
21416
  tags:
21248
21417
  - event
21418
+ x-required-permissions:
21419
+ - events:read
21249
21420
  patch:
21250
21421
  description: Acknowledge an event
21251
21422
  operationId: acknowledge_event_v1_events__event_id__patch
@@ -21301,6 +21472,8 @@ paths:
21301
21472
  summary: Acknowledge event
21302
21473
  tags:
21303
21474
  - event
21475
+ x-required-permissions:
21476
+ - events:manage
21304
21477
  /v1/job/{job_id}:
21305
21478
  delete:
21306
21479
  operationId: delete_job_v1_job__job_id__delete
@@ -21345,6 +21518,8 @@ paths:
21345
21518
  summary: Delete (cancel) a queued job
21346
21519
  tags:
21347
21520
  - jobs
21521
+ x-required-permissions:
21522
+ - jobs:manage
21348
21523
  get:
21349
21524
  operationId: get_job_v1_job__job_id__get
21350
21525
  parameters:
@@ -21392,6 +21567,8 @@ paths:
21392
21567
  summary: Get individual job details
21393
21568
  tags:
21394
21569
  - jobs
21570
+ x-required-permissions:
21571
+ - jobs:read
21395
21572
  /v1/job/{job_id}/pause:
21396
21573
  post:
21397
21574
  operationId: pause_job_v1_job__job_id__pause_post
@@ -21436,6 +21613,8 @@ paths:
21436
21613
  summary: Pause a job
21437
21614
  tags:
21438
21615
  - jobs
21616
+ x-required-permissions:
21617
+ - jobs:manage
21439
21618
  /v1/job/{job_id}/resume:
21440
21619
  post:
21441
21620
  operationId: resume_job_v1_job__job_id__resume_post
@@ -21484,6 +21663,8 @@ paths:
21484
21663
  summary: Resume a paused job
21485
21664
  tags:
21486
21665
  - jobs
21666
+ x-required-permissions:
21667
+ - jobs:manage
21487
21668
  /v1/job/{job_id}/retry:
21488
21669
  post:
21489
21670
  operationId: retry_job_v1_job__job_id__retry_post
@@ -21544,6 +21725,8 @@ paths:
21544
21725
  summary: Retry a failed or dead-lettered job
21545
21726
  tags:
21546
21727
  - jobs
21728
+ x-required-permissions:
21729
+ - jobs:manage
21547
21730
  /v1/jobs:
21548
21731
  get:
21549
21732
  operationId: list_batches_v1_jobs_get
@@ -21610,6 +21793,8 @@ paths:
21610
21793
  summary: List batches for organization
21611
21794
  tags:
21612
21795
  - jobs
21796
+ x-required-permissions:
21797
+ - jobs:read
21613
21798
  post:
21614
21799
  operationId: create_batch_v1_jobs_post
21615
21800
  requestBody:
@@ -22096,6 +22281,12 @@ paths:
22096
22281
  summary: Create a batch of commands for async execution
22097
22282
  tags:
22098
22283
  - jobs
22284
+ x-required-permissions:
22285
+ - contacts:manage
22286
+ - dns:manage
22287
+ - domains:manage
22288
+ - jobs:manage
22289
+ - parking:manage
22099
22290
  /v1/jobs/{batch_id}:
22100
22291
  delete:
22101
22292
  operationId: delete_batch_v1_jobs__batch_id__delete
@@ -22140,6 +22331,8 @@ paths:
22140
22331
  summary: Delete (cancel) all queued jobs in a batch
22141
22332
  tags:
22142
22333
  - jobs
22334
+ x-required-permissions:
22335
+ - jobs:manage
22143
22336
  get:
22144
22337
  operationId: get_batch_v1_jobs__batch_id__get
22145
22338
  parameters:
@@ -22246,6 +22439,8 @@ paths:
22246
22439
  summary: Get batch details and execution status
22247
22440
  tags:
22248
22441
  - jobs
22442
+ x-required-permissions:
22443
+ - jobs:read
22249
22444
  /v1/jobs/{batch_id}/jobs:
22250
22445
  get:
22251
22446
  operationId: get_batch_jobs_v1_jobs__batch_id__jobs_get
@@ -22529,6 +22724,8 @@ paths:
22529
22724
  summary: Get individual jobs within a batch
22530
22725
  tags:
22531
22726
  - jobs
22727
+ x-required-permissions:
22728
+ - jobs:read
22532
22729
  /v1/jobs/{batch_id}/pause:
22533
22730
  post:
22534
22731
  operationId: pause_batch_v1_jobs__batch_id__pause_post
@@ -22573,6 +22770,8 @@ paths:
22573
22770
  summary: Pause all eligible jobs in a batch
22574
22771
  tags:
22575
22772
  - jobs
22773
+ x-required-permissions:
22774
+ - jobs:manage
22576
22775
  /v1/jobs/{batch_id}/resume:
22577
22776
  post:
22578
22777
  operationId: resume_batch_v1_jobs__batch_id__resume_post
@@ -22617,6 +22816,8 @@ paths:
22617
22816
  summary: Resume all paused jobs in a batch
22618
22817
  tags:
22619
22818
  - jobs
22819
+ x-required-permissions:
22820
+ - jobs:manage
22620
22821
  /v1/jobs/{batch_id}/retry:
22621
22822
  post:
22622
22823
  operationId: retry_batch_v1_jobs__batch_id__retry_post
@@ -22683,6 +22884,8 @@ paths:
22683
22884
  summary: Retry failed and dead-lettered jobs in a batch
22684
22885
  tags:
22685
22886
  - jobs
22887
+ x-required-permissions:
22888
+ - jobs:manage
22686
22889
  /v1/organizations:
22687
22890
  get:
22688
22891
  description: Retrieves a paginated list of organizations under the current organization
@@ -23707,6 +23910,8 @@ paths:
23707
23910
  summary: List all invoices for the organization
23708
23911
  tags:
23709
23912
  - organization
23913
+ x-required-permissions:
23914
+ - billing:manage
23710
23915
  /v1/organizations/{organization_id}/pricing/product-type/{product_type}:
23711
23916
  get:
23712
23917
  description: Retrieves pricing data for a specific product type. If a product
@@ -24117,6 +24322,8 @@ paths:
24117
24322
  summary: List parking entries
24118
24323
  tags:
24119
24324
  - parking
24325
+ x-required-permissions:
24326
+ - parking:read
24120
24327
  /v1/parking/metrics:
24121
24328
  get:
24122
24329
  description: Retrieves aggregated metrics for all parking entries of the organization.
@@ -24183,6 +24390,8 @@ paths:
24183
24390
  summary: Get total metrics for all parking entries
24184
24391
  tags:
24185
24392
  - parking
24393
+ x-required-permissions:
24394
+ - parking:read
24186
24395
  /v1/parking/signup:
24187
24396
  post:
24188
24397
  description: Accept the parking agreement to enable parking features for your
@@ -24236,6 +24445,8 @@ paths:
24236
24445
  summary: Sign up for parking
24237
24446
  tags:
24238
24447
  - parking
24448
+ x-required-permissions:
24449
+ - parking:manage
24239
24450
  /v1/parking/signup/status:
24240
24451
  get:
24241
24452
  description: Check if your organization has accepted the parking agreement.
@@ -24283,6 +24494,8 @@ paths:
24283
24494
  summary: Get parking signup status
24284
24495
  tags:
24285
24496
  - parking
24497
+ x-required-permissions:
24498
+ - parking:read
24286
24499
  /v1/parking/{parking_reference}/metrics:
24287
24500
  get:
24288
24501
  description: Retrieves metrics for a specific parking entry by ID or domain
@@ -24375,6 +24588,8 @@ paths:
24375
24588
  summary: Get metrics for a parking entry
24376
24589
  tags:
24377
24590
  - parking
24591
+ x-required-permissions:
24592
+ - parking:read
24378
24593
  /v1/reports:
24379
24594
  get:
24380
24595
  operationId: list_reports_v1_reports_get
@@ -24631,6 +24846,8 @@ paths:
24631
24846
  summary: List tags
24632
24847
  tags:
24633
24848
  - tag
24849
+ x-required-permissions:
24850
+ - tags:read
24634
24851
  post:
24635
24852
  description: Create a new tag
24636
24853
  operationId: create_tag_v1_tags_post
@@ -24684,6 +24901,8 @@ paths:
24684
24901
  summary: Create a tag
24685
24902
  tags:
24686
24903
  - tag
24904
+ x-required-permissions:
24905
+ - tags:manage
24687
24906
  /v1/tags/objects:
24688
24907
  post:
24689
24908
  description: Add, remove, or replace tags on multiple objects at once. 'replace'
@@ -24752,6 +24971,8 @@ paths:
24752
24971
  summary: Bulk tag or untag objects
24753
24972
  tags:
24754
24973
  - tag
24974
+ x-required-permissions:
24975
+ - tags:manage
24755
24976
  /v1/tags/{tag_id}:
24756
24977
  delete:
24757
24978
  description: Delete a tag
@@ -24808,6 +25029,8 @@ paths:
24808
25029
  summary: Delete a tag
24809
25030
  tags:
24810
25031
  - tag
25032
+ x-required-permissions:
25033
+ - tags:delete
24811
25034
  get:
24812
25035
  description: Retrieve a single tag by its ID
24813
25036
  operationId: get_tag_v1_tags__tag_id__get
@@ -24867,6 +25090,8 @@ paths:
24867
25090
  summary: Get a tag
24868
25091
  tags:
24869
25092
  - tag
25093
+ x-required-permissions:
25094
+ - tags:read
24870
25095
  patch:
24871
25096
  description: Update a tag's label, description, or color
24872
25097
  operationId: update_tag_v1_tags__tag_id__patch
@@ -24945,6 +25170,8 @@ paths:
24945
25170
  summary: Update a tag
24946
25171
  tags:
24947
25172
  - tag
25173
+ x-required-permissions:
25174
+ - tags:manage
24948
25175
  /v1/tags/{tag_id}/objects:
24949
25176
  post:
24950
25177
  description: Add or remove objects from a tag. Objects are matched by the tag's
@@ -25012,6 +25239,8 @@ paths:
25012
25239
  summary: Tag or untag objects
25013
25240
  tags:
25014
25241
  - tag
25242
+ x-required-permissions:
25243
+ - tags:manage
25015
25244
  /v1/tlds/:
25016
25245
  get:
25017
25246
  description: Retrieves a list of TLD Specifications we have support for
@@ -25155,6 +25384,8 @@ paths:
25155
25384
  summary: Create a user
25156
25385
  tags:
25157
25386
  - user
25387
+ x-required-permissions:
25388
+ - users:manage
25158
25389
  /v1/users/me:
25159
25390
  get:
25160
25391
  description: Get the current user
@@ -25188,6 +25419,8 @@ paths:
25188
25419
  summary: Get current user
25189
25420
  tags:
25190
25421
  - user
25422
+ x-required-permissions:
25423
+ - users:read
25191
25424
  /v1/users/me/password-reset:
25192
25425
  patch:
25193
25426
  operationId: change_password_v1_users_me_password_reset_patch
@@ -25223,6 +25456,8 @@ paths:
25223
25456
  summary: Change Password
25224
25457
  tags:
25225
25458
  - user
25459
+ x-required-permissions:
25460
+ - users:manage
25226
25461
  /v1/users/{user_id}:
25227
25462
  delete:
25228
25463
  description: Delete a user by ID
@@ -25278,6 +25513,8 @@ paths:
25278
25513
  summary: Delete a user
25279
25514
  tags:
25280
25515
  - user
25516
+ x-required-permissions:
25517
+ - users:delete
25281
25518
  get:
25282
25519
  description: Get a user by ID
25283
25520
  operationId: get_user_v1_users__user_id__get
@@ -25322,6 +25559,8 @@ paths:
25322
25559
  summary: Get a user
25323
25560
  tags:
25324
25561
  - user
25562
+ x-required-permissions:
25563
+ - users:read
25325
25564
  patch:
25326
25565
  description: Update a user by ID
25327
25566
  operationId: update_user_v1_users__user_id__patch
@@ -25362,6 +25601,8 @@ paths:
25362
25601
  summary: Update a user
25363
25602
  tags:
25364
25603
  - user
25604
+ x-required-permissions:
25605
+ - users:manage
25365
25606
  /v1/users/{user_id}/permissions:
25366
25607
  get:
25367
25608
  description: Get the permissions for a user
@@ -25397,6 +25638,8 @@ paths:
25397
25638
  summary: Get user permissions
25398
25639
  tags:
25399
25640
  - user
25641
+ x-required-permissions:
25642
+ - users:read
25400
25643
  /v1/users/{user_id}/role:
25401
25644
  get:
25402
25645
  description: Get the role for a user
@@ -25432,6 +25675,8 @@ paths:
25432
25675
  summary: Get user role
25433
25676
  tags:
25434
25677
  - user
25678
+ x-required-permissions:
25679
+ - users:read
25435
25680
  put:
25436
25681
  description: Set the role for a user, replacing any existing role
25437
25682
  operationId: set_user_role_v1_users__user_id__role_put