feat(devices): add registrations support

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1684
+configured_endpoints: 1691
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-c8a483b60e85304db5b4d26e271043cf4c8cb135e2487ceb22aa7b7790c41a0f.yml
 openapi_spec_hash: aef6298ba0d4acc775a8bf4000f63aff
-config_hash: 8f48b7965f4de0a038d73edafff0c9a1
+config_hash: 5498974bd745dfa9f5bea3f292c4e917

api.md

@@ -4557,6 +4557,26 @@ Methods:
 - <code title="post /accounts/{account_id}/devices/resilience/disconnect">client.zeroTrust.devices.resilience.globalWARPOverride.<a href="./src/resources/zero-trust/devices/resilience/global-warp-override.ts">create</a>({ ...params }) -> GlobalWARPOverrideCreateResponse | null</code>
 - <code title="get /accounts/{account_id}/devices/resilience/disconnect">client.zeroTrust.devices.resilience.globalWARPOverride.<a href="./src/resources/zero-trust/devices/resilience/global-warp-override.ts">get</a>({ ...params }) -> GlobalWARPOverrideGetResponse | null</code>
 
+### Registrations
+
+Types:
+
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationListResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationDeleteResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationBulkDeleteResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationGetResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationRevokeResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/registrations.ts">RegistrationUnrevokeResponse</a></code>
+
+Methods:
+
+- <code title="get /accounts/{account_id}/devices/registrations">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">list</a>({ ...params }) -> RegistrationListResponsesCursorPagination</code>
+- <code title="delete /accounts/{account_id}/devices/registrations/{registration_id}">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">delete</a>(registrationId, { ...params }) -> RegistrationDeleteResponse | null</code>
+- <code title="delete /accounts/{account_id}/devices/registrations">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">bulkDelete</a>({ ...params }) -> RegistrationBulkDeleteResponse | null</code>
+- <code title="get /accounts/{account_id}/devices/registrations/{registration_id}">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">get</a>(registrationId, { ...params }) -> RegistrationGetResponse</code>
+- <code title="post /accounts/{account_id}/devices/registrations/revoke">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">revoke</a>({ ...params }) -> RegistrationRevokeResponse | null</code>
+- <code title="post /accounts/{account_id}/devices/registrations/unrevoke">client.zeroTrust.devices.registrations.<a href="./src/resources/zero-trust/devices/registrations.ts">unrevoke</a>({ ...params }) -> RegistrationUnrevokeResponse | null</code>
+
 ### DEXTests
 
 Types:
@@ -4769,10 +4789,12 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/zero-trust/devices/override-codes.ts">OverrideCodeListResponse</a></code>
+- <code><a href="./src/resources/zero-trust/devices/override-codes.ts">OverrideCodeGetResponse</a></code>
 
 Methods:
 
 - <code title="get /accounts/{account_id}/devices/{device_id}/override_codes">client.zeroTrust.devices.overrideCodes.<a href="./src/resources/zero-trust/devices/override-codes.ts">list</a>(deviceId, { ...params }) -> OverrideCodeListResponse | null</code>
+- <code title="get /accounts/{account_id}/devices/registrations/{registration_id}/override_codes">client.zeroTrust.devices.overrideCodes.<a href="./src/resources/zero-trust/devices/override-codes.ts">get</a>(registrationId, { ...params }) -> OverrideCodeGetResponse</code>
 
 ## IdentityProviders
 

src/resources/zero-trust/devices/devices.ts

@@ -30,7 +30,30 @@ import {
   Networks,
 } from './networks';
 import * as OverrideCodesAPI from './override-codes';
-import { OverrideCodeListParams, OverrideCodeListResponse, OverrideCodes } from './override-codes';
+import {
+  OverrideCodeGetParams,
+  OverrideCodeGetResponse,
+  OverrideCodeListParams,
+  OverrideCodeListResponse,
+  OverrideCodes,
+} from './override-codes';
+import * as RegistrationsAPI from './registrations';
+import {
+  RegistrationBulkDeleteParams,
+  RegistrationBulkDeleteResponse,
+  RegistrationDeleteParams,
+  RegistrationDeleteResponse,
+  RegistrationGetParams,
+  RegistrationGetResponse,
+  RegistrationListParams,
+  RegistrationListResponse,
+  RegistrationListResponsesCursorPagination,
+  RegistrationRevokeParams,
+  RegistrationRevokeResponse,
+  RegistrationUnrevokeParams,
+  RegistrationUnrevokeResponse,
+  Registrations,
+} from './registrations';
 import * as RevokeAPI from './revoke';
 import { Revoke, RevokeCreateParams, RevokeCreateResponse } from './revoke';
 import * as SettingsAPI from './settings';
@@ -88,6 +111,7 @@ import { SinglePage } from '../../../pagination';
 
 export class Devices extends APIResource {
   resilience: ResilienceAPI.Resilience = new ResilienceAPI.Resilience(this._client);
+  registrations: RegistrationsAPI.Registrations = new RegistrationsAPI.Registrations(this._client);
   dexTests: DEXTestsAPI.DEXTests = new DEXTestsAPI.DEXTests(this._client);
   networks: NetworksAPI.Networks = new NetworksAPI.Networks(this._client);
   fleetStatus: FleetStatusAPI.FleetStatus = new FleetStatusAPI.FleetStatus(this._client);
@@ -386,6 +410,8 @@ export interface DeviceGetParams {
 
 Devices.DevicesSinglePage = DevicesSinglePage;
 Devices.Resilience = Resilience;
+Devices.Registrations = Registrations;
+Devices.RegistrationListResponsesCursorPagination = RegistrationListResponsesCursorPagination;
 Devices.DEXTests = DEXTests;
 Devices.SchemaHTTPSSinglePage = SchemaHTTPSSinglePage;
 Devices.Networks = Networks;
@@ -410,6 +436,23 @@ export declare namespace Devices {
 
   export { Resilience as Resilience };
 
+  export {
+    Registrations as Registrations,
+    type RegistrationListResponse as RegistrationListResponse,
+    type RegistrationDeleteResponse as RegistrationDeleteResponse,
+    type RegistrationBulkDeleteResponse as RegistrationBulkDeleteResponse,
+    type RegistrationGetResponse as RegistrationGetResponse,
+    type RegistrationRevokeResponse as RegistrationRevokeResponse,
+    type RegistrationUnrevokeResponse as RegistrationUnrevokeResponse,
+    RegistrationListResponsesCursorPagination as RegistrationListResponsesCursorPagination,
+    type RegistrationListParams as RegistrationListParams,
+    type RegistrationDeleteParams as RegistrationDeleteParams,
+    type RegistrationBulkDeleteParams as RegistrationBulkDeleteParams,
+    type RegistrationGetParams as RegistrationGetParams,
+    type RegistrationRevokeParams as RegistrationRevokeParams,
+    type RegistrationUnrevokeParams as RegistrationUnrevokeParams,
+  };
+
   export {
     DEXTests as DEXTests,
     type DEXTest as DEXTest,
@@ -503,6 +546,8 @@ export declare namespace Devices {
   export {
     OverrideCodes as OverrideCodes,
     type OverrideCodeListResponse as OverrideCodeListResponse,
+    type OverrideCodeGetResponse as OverrideCodeGetResponse,
     type OverrideCodeListParams as OverrideCodeListParams,
+    type OverrideCodeGetParams as OverrideCodeGetParams,
   };
 }

src/resources/zero-trust/devices/index.ts

@@ -47,7 +47,29 @@ export {
   type DeviceGetParams,
 } from './devices';
 export { FleetStatus, type FleetStatusGetResponse, type FleetStatusGetParams } from './fleet-status';
-export { OverrideCodes, type OverrideCodeListResponse, type OverrideCodeListParams } from './override-codes';
+export {
+  OverrideCodes,
+  type OverrideCodeListResponse,
+  type OverrideCodeGetResponse,
+  type OverrideCodeListParams,
+  type OverrideCodeGetParams,
+} from './override-codes';
+export {
+  RegistrationListResponsesCursorPagination,
+  Registrations,
+  type RegistrationListResponse,
+  type RegistrationDeleteResponse,
+  type RegistrationBulkDeleteResponse,
+  type RegistrationGetResponse,
+  type RegistrationRevokeResponse,
+  type RegistrationUnrevokeResponse,
+  type RegistrationListParams,
+  type RegistrationDeleteParams,
+  type RegistrationBulkDeleteParams,
+  type RegistrationGetParams,
+  type RegistrationRevokeParams,
+  type RegistrationUnrevokeParams,
+} from './registrations';
 export { Resilience } from './resilience/index';
 export { Revoke, type RevokeCreateResponse, type RevokeCreateParams } from './revoke';
 export {

src/resources/zero-trust/devices/override-codes.ts

@@ -25,6 +25,24 @@ export class OverrideCodes extends APIResource {
       ) as Core.APIPromise<{ result: OverrideCodeListResponse | null }>
     )._thenUnwrap((obj) => obj.result);
   }
+
+  /**
+   * Fetches one-time use admin override codes for a registration. This relies on the
+   * **Admin Override** setting being enabled in your device configuration.
+   */
+  get(
+    registrationId: string,
+    params: OverrideCodeGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<OverrideCodeGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/devices/registrations/${registrationId}/override_codes`,
+        options,
+      ) as Core.APIPromise<{ result: OverrideCodeGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
 }
 
 export interface OverrideCodeListResponse {
@@ -60,13 +78,23 @@ export namespace OverrideCodeListResponse {
   }
 }
 
+export interface OverrideCodeGetResponse {
+  disable_for_time?: Record<string, string>;
+}
+
 export interface OverrideCodeListParams {
   account_id: string;
 }
 
+export interface OverrideCodeGetParams {
+  account_id: string;
+}
+
 export declare namespace OverrideCodes {
   export {
     type OverrideCodeListResponse as OverrideCodeListResponse,
+    type OverrideCodeGetResponse as OverrideCodeGetResponse,
     type OverrideCodeListParams as OverrideCodeListParams,
+    type OverrideCodeGetParams as OverrideCodeGetParams,
   };
 }