UNPKG

auth0

Version:

Auth0 Node.js SDK for the Management API v2.

3,430 lines (2,401 loc) 433 kB
# Reference ## Actions <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.Action, Management.ListActionsPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve all actions. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.actions.list({ triggerId: "post-login", actionName: "actionName", deployed: true, page: 1, per_page: 1, installed: true, }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.actions.list({ triggerId: "post-login", actionName: "actionName", deployed: true, page: 1, per_page: 1, installed: true, }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListActionsRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">create</a>({ ...params }) -> Management.CreateActionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create an action. Once an action is created, it must be deployed, and then bound to a trigger before it will be executed as part of a flow. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.create({ name: "name", supported_triggers: [ { id: "post-login", }, ], }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateActionRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">get</a>(id) -> Management.GetActionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve an action by its ID. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.get("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The ID of the action to retrieve. </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">delete</a>(id, { ...params }) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Deletes an action and all of its associated versions. An action must be unbound from all triggers before it can be deleted. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.delete("id", { force: true, }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The ID of the action to delete. </dd> </dl> <dl> <dd> **request:** `Management.DeleteActionRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateActionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update an existing action. If this action is currently bound to a trigger, updating it will **not** affect any user flows until the action is deployed. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the action to update. </dd> </dl> <dl> <dd> **request:** `Management.UpdateActionRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">deploy</a>(id) -> Management.DeployActionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Deploy an action. Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately. Otherwise, the action will only be executed as a part of a flow once it is bound to that flow. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.deploy("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The ID of an action. </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.actions.<a href="/src/management/api/resources/actions/client/Client.ts">test</a>(id, { ...params }) -> Management.TestActionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Test an action. After updating an action, it can be tested prior to being deployed to ensure it behaves as expected. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.actions.test("id", { payload: { key: "value", }, }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the action to test. </dd> </dl> <dl> <dd> **request:** `Management.TestActionRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ActionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## Branding <details><summary><code>client.branding.<a href="/src/management/api/resources/branding/client/Client.ts">get</a>() -> Management.GetBrandingResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve branding settings. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.branding.get(); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **requestOptions:** `BrandingClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.branding.<a href="/src/management/api/resources/branding/client/Client.ts">update</a>({ ...params }) -> Management.UpdateBrandingResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update branding settings. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.branding.update(); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.UpdateBrandingRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `BrandingClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## ClientGrants <details><summary><code>client.clientGrants.<a href="/src/management/api/resources/clientGrants/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.ClientGrantResponseContent, Management.ListClientGrantPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a list of [client grants](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants), including the scopes associated with the application/API pair. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.clientGrants.list({ from: "from", take: 1, audience: "audience", client_id: "client_id", allow_any_organization: true, subject_type: "client", default_for: "third_party_clients", }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.clientGrants.list({ from: "from", take: 1, audience: "audience", client_id: "client_id", allow_any_organization: true, subject_type: "client", default_for: "third_party_clients", }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListClientGrantsRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ClientGrantsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clientGrants.<a href="/src/management/api/resources/clientGrants/client/Client.ts">create</a>({ ...params }) -> Management.CreateClientGrantResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create a client grant for a machine-to-machine login flow. To learn more, read [Client Credential Flow](https://www.auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow). </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clientGrants.create({ audience: "audience", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateClientGrantRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientGrantsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clientGrants.<a href="/src/management/api/resources/clientGrants/client/Client.ts">get</a>(id) -> Management.GetClientGrantResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a single [client grant](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants), including the scopes associated with the application/API pair. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clientGrants.get("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The ID of the client grant to retrieve. </dd> </dl> <dl> <dd> **requestOptions:** `ClientGrantsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clientGrants.<a href="/src/management/api/resources/clientGrants/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Delete the [Client Credential Flow](https://www.auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow) from your machine-to-machine application. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clientGrants.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client grant to delete. </dd> </dl> <dl> <dd> **requestOptions:** `ClientGrantsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clientGrants.<a href="/src/management/api/resources/clientGrants/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateClientGrantResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update a client grant. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clientGrants.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client grant to update. </dd> </dl> <dl> <dd> **request:** `Management.UpdateClientGrantRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientGrantsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## Clients <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.Client, Management.ListClientsOffsetPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve clients (applications and SSO integrations) matching provided filters. A list of fields to include or exclude may also be specified. For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on). - The following can be retrieved with any scope: `client_id`, `app_type`, `name`, and `description`. - The following properties can only be retrieved with the `read:clients` or `read:client_keys` scope: `callbacks`, `oidc_logout`, `allowed_origins`, `web_origins`, `tenant`, `global`, `config_route`, `callback_url_template`, `jwt_configuration`, `jwt_configuration.lifetime_in_seconds`, `jwt_configuration.secret_encoded`, `jwt_configuration.scopes`, `jwt_configuration.alg`, `api_type`, `logo_uri`, `allowed_clients`, `owners`, `custom_login_page`, `custom_login_page_off`, `sso`, `addons`, `form_template`, `custom_login_page_codeview`, `resource_servers`, `client_metadata`, `mobile`, `mobile.android`, `mobile.ios`, `allowed_logout_urls`, `token_endpoint_auth_method`, `is_first_party`, `oidc_conformant`, `is_token_endpoint_ip_header_trusted`, `initiate_login_uri`, `grant_types`, `refresh_token`, `refresh_token.rotation_type`, `refresh_token.expiration_type`, `refresh_token.leeway`, `refresh_token.token_lifetime`, `refresh_token.policies`, `organization_usage`, `organization_require_behavior`. - The following properties can only be retrieved with the `read:client_keys` or `read:client_credentials` scope: `encryption_key`, `encryption_key.pub`, `encryption_key.cert`, `client_secret`, `client_authentication_methods` and `signing_key`. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.clients.list({ fields: "fields", include_fields: true, page: 1, per_page: 1, include_totals: true, is_global: true, is_first_party: true, app_type: "app_type", external_client_id: "external_client_id", q: "q", }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.clients.list({ fields: "fields", include_fields: true, page: 1, per_page: 1, include_totals: true, is_global: true, is_first_party: true, app_type: "app_type", external_client_id: "external_client_id", q: "q", }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListClientsRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">create</a>({ ...params }) -> Management.CreateClientResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create a new client (application or SSO integration). For more information, read [Create Applications](https://www.auth0.com/docs/get-started/auth0-overview/create-applications) [API Endpoints for Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on/api-endpoints-for-single-sign-on). Notes: - We recommend leaving the `client_secret` parameter unspecified to allow the generation of a safe secret. - The `client_authentication_methods` and `token_endpoint_auth_method` properties are mutually exclusive. Use `client_authentication_methods` to configure the client with Private Key JWT authentication method. Otherwise, use `token_endpoint_auth_method` to configure the client with client secret (basic or post) or with no authentication method (none). - When using `client_authentication_methods` to configure the client with Private Key JWT authentication method, specify fully defined credentials. These credentials will be automatically enabled for Private Key JWT authentication on the client. - To configure `client_authentication_methods`, the `create:client_credentials` scope is required. - To configure `client_authentication_methods`, the property `jwt_configuration.alg` must be set to RS256. SSO Integrations created via this endpoint will accept login requests and share user profile information. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.create({ name: "name", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateClientRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">previewCimdMetadata</a>({ ...params }) -> Management.PreviewCimdMetadataResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Fetches and validates a Client ID Metadata Document without creating a client. Returns the raw metadata and how it would be mapped to Auth0 client fields. This endpoint is useful for testing metadata URIs before creating CIMD clients. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.previewCimdMetadata({ external_client_id: "external_client_id", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.PreviewCimdMetadataRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">registerCimdClient</a>({ ...params }) -> Management.RegisterCimdClientResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Idempotent registration for Client ID Metadata Document (CIMD) clients. Uses external_client_id as the unique identifier for upsert operations. **Create:** Returns 201 when a new client is created (requires `create:clients` scope). **Update:** Returns 200 when an existing client is updated (requires `update:clients` scope). This endpoint automatically: - Fetches and validates the metadata document - Maps CIMD fields to Auth0 client configuration - Creates/rotates credentials from the JWKS - Enforces CIMD security policies (HTTPS-only, no shared secrets) </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.registerCimdClient({ external_client_id: "external_client_id", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.RegisterCimdClientRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">get</a>(id, { ...params }) -> Management.GetClientResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve client details by ID. Clients are SSO connections or Applications linked with your Auth0 tenant. A list of fields to include or exclude may also be specified. For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on). - The following properties can be retrieved with any of the scopes: `client_id`, `app_type`, `name`, and `description`. - The following properties can only be retrieved with the `read:clients` or `read:client_keys` scopes: `callbacks`, `oidc_logout`, `allowed_origins`, `web_origins`, `tenant`, `global`, `config_route`, `callback_url_template`, `jwt_configuration`, `jwt_configuration.lifetime_in_seconds`, `jwt_configuration.secret_encoded`, `jwt_configuration.scopes`, `jwt_configuration.alg`, `api_type`, `logo_uri`, `allowed_clients`, `owners`, `custom_login_page`, `custom_login_page_off`, `sso`, `addons`, `form_template`, `custom_login_page_codeview`, `resource_servers`, `client_metadata`, `mobile`, `mobile.android`, `mobile.ios`, `allowed_logout_urls`, `token_endpoint_auth_method`, `is_first_party`, `oidc_conformant`, `is_token_endpoint_ip_header_trusted`, `initiate_login_uri`, `grant_types`, `refresh_token`, `refresh_token.rotation_type`, `refresh_token.expiration_type`, `refresh_token.leeway`, `refresh_token.token_lifetime`, `refresh_token.policies`, `organization_usage`, `organization_require_behavior`. - The following properties can only be retrieved with the `read:client_keys` or `read:client_credentials` scopes: `encryption_key`, `encryption_key.pub`, `encryption_key.cert`, `client_secret`, `client_authentication_methods` and `signing_key`. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.get("id", { fields: "fields", include_fields: true, }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client to retrieve. </dd> </dl> <dl> <dd> **request:** `Management.GetClientRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Delete a client and related configuration (rules, connections, etc). </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client to delete. </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateClientResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Updates a client's settings. For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on). Notes: - The `client_secret` and `signing_key` attributes can only be updated with the `update:client_keys` scope. - The `client_authentication_methods` and `token_endpoint_auth_method` properties are mutually exclusive. Use `client_authentication_methods` to configure the client with Private Key JWT authentication method. Otherwise, use `token_endpoint_auth_method` to configure the client with client secret (basic or post) or with no authentication method (none). - When using `client_authentication_methods` to configure the client with Private Key JWT authentication method, only specify the credential IDs that were generated when creating the credentials on the client. - To configure `client_authentication_methods`, the `update:client_credentials` scope is required. - To configure `client_authentication_methods`, the property `jwt_configuration.alg` must be set to RS256. - To change a client's `is_first_party` property to `false`, the `organization_usage` and `organization_require_behavior` properties must be unset. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client to update. </dd> </dl> <dl> <dd> **request:** `Management.UpdateClientRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.clients.<a href="/src/management/api/resources/clients/client/Client.ts">rotateSecret</a>(id) -> Management.RotateClientSecretResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Rotate a client secret. This endpoint cannot be used with clients configured with Private Key JWT authentication method (client_authentication_methods configured with private_key_jwt). The generated secret is NOT base64 encoded. For more information, read [Rotate Client Secrets](https://www.auth0.com/docs/get-started/applications/rotate-client-secret). </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.clients.rotateSecret("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the client that will rotate secrets. </dd> </dl> <dl> <dd> **requestOptions:** `ClientsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## ConnectionProfiles <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.ConnectionProfile, Management.ListConnectionProfilesPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a list of Connection Profiles. This endpoint supports Checkpoint pagination. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.connectionProfiles.list({ from: "from", take: 1, }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.connectionProfiles.list({ from: "from", take: 1, }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListConnectionProfileRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">create</a>({ ...params }) -> Management.CreateConnectionProfileResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create a Connection Profile. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.create({ name: "name", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateConnectionProfileRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">listTemplates</a>() -> Management.ListConnectionProfileTemplateResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a list of Connection Profile Templates. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.listTemplates(); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">getTemplate</a>(id) -> Management.GetConnectionProfileTemplateResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a Connection Profile Template. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.getTemplate("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the connection-profile-template to retrieve. </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">get</a>(id) -> Management.GetConnectionProfileResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve details about a single Connection Profile specified by ID. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.get("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the connection-profile to retrieve. </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Delete a single Connection Profile specified by ID. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the connection-profile to delete. </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connectionProfiles.<a href="/src/management/api/resources/connectionProfiles/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateConnectionProfileResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update the details of a specific Connection Profile. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connectionProfiles.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the connection profile to update. </dd> </dl> <dl> <dd> **request:** `Management.UpdateConnectionProfileRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionProfilesClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## Connections <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.ConnectionForList, Management.ListConnectionsCheckpointPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieves detailed list of all [connections](https://auth0.com/docs/authenticate/identity-providers) that match the specified strategy. If no strategy is provided, all connections within your tenant are retrieved. This action can accept a list of fields to include or exclude from the resulting list of connections. This endpoint supports two types of pagination: - Offset pagination - Checkpoint pagination Checkpoint pagination must be used if you need to retrieve more than 1000 connections. **Checkpoint Pagination** To search by checkpoint, use the following parameters: - `from`: Optional id from which to start selection. - `take`: The total amount of entries to retrieve when using the from parameter. Defaults to 50. **Note**: The first time you call this endpoint using checkpoint pagination, omit the `from` parameter. If there are more results, a `next` value is included in the response. You can use this for subsequent API calls. When `next` is no longer included in the response, no pages are remaining. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.connections.list({ from: "from", take: 1, strategy: ["ad"], name: "name", fields: "fields", include_fields: true, }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.connections.list({ from: "from", take: 1, strategy: ["ad"], name: "name", fields: "fields", include_fields: true, }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListConnectionsQueryParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">create</a>({ ...params }) -> Management.CreateConnectionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Creates a new connection according to the JSON object received in `body`. **Note:** If a connection with the same name was recently deleted and had a large number of associated users, the deletion may still be processing. Creating a new connection with that name before the deletion completes may fail or produce unexpected results. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connections.create({ name: "name", strategy: "ad", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateConnectionRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">get</a>(id, { ...params }) -> Management.GetConnectionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve details for a specified [connection](https://auth0.com/docs/authenticate/identity-providers) along with options that can be used for identity provider configuration. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connections.get("id", { fields: "fields", include_fields: true, }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the connection to retrieve </dd> </dl> <dl> <dd> **request:** `Management.GetConnectionRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Removes a specific [connection](https://auth0.com/docs/authenticate/identity-providers) from your tenant. This action cannot be undone. Once removed, users can no longer use this connection to authenticate. **Note:** If your connection has a large amount of users associated with it, please be aware that this operation can be long running after the response is returned and may impact concurrent [create connection](https://auth0.com/docs/api/management/v2/connections/post-connections) requests, if they use an identical connection name. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connections.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the connection to delete </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateConnectionResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update details for a specific [connection](https://auth0.com/docs/authenticate/identity-providers), including option properties for identity provider configuration. **Note**: If you use the `options` parameter, the entire `options` object is overridden. To avoid partial data or other issues, ensure all parameters are present when using this option. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connections.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the connection to update </dd> </dl> <dl> <dd> **request:** `Management.UpdateConnectionRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.connections.<a href="/src/management/api/resources/connections/client/Client.ts">checkStatus</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieves the status of an ad/ldap connection referenced by its `ID`. `200 OK` http status code response is returned when the connection is online, otherwise a `404` status code is returned along with an error message </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.connections.checkStatus("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the connection to check </dd> </dl> <dl> <dd> **requestOptions:** `ConnectionsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## CustomDomains <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">list</a>({ ...params }) -> Management.ListCustomDomainsResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve details on [custom domains](https://auth0.com/docs/custom-domains). </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.list({ q: "q", fields: "fields", include_fields: true, sort: "sort", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListCustomDomainsRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">create</a>({ ...params }) -> Management.CreateCustomDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create a new custom domain. Note: The custom domain will need to be verified before it will accept requests. Optional attributes that can be updated: - custom_client_ip_header - tls_policy TLS Policies: - recommended - for modern usage this includes TLS 1.2 only </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.create({ domain: "domain", type: "auth0_managed_certs", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreateCustomDomainRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">getDefault</a>() -> Management.GetDefaultDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve the tenant's default domain. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.getDefault(); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">setDefault</a>({ ...params }) -> Management.UpdateDefaultDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Set the default custom domain for the tenant. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.setDefault({ domain: "domain", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.SetDefaultCustomDomainRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">get</a>(id) -> Management.GetCustomDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve a custom domain configuration and status. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.get("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the custom domain to retrieve. </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Delete a custom domain and stop serving requests for it. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the custom domain to delete. </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">update</a>(id, { ...params }) -> Management.UpdateCustomDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Update a custom domain. These are the attributes that can be updated: - custom_client_ip_header - tls_policy **Updating CUSTOM_CLIENT_IP_HEADER for a custom domain** To update the `custom_client_ip_header` for a domain, the body to send should be: ```json { "custom_client_ip_header": "cf-connecting-ip" } ``` **Updating TLS_POLICY for a custom domain** To update the `tls_policy` for a domain, the body to send should be: ```json { "tls_policy": "recommended" } ``` TLS Policies: - recommended - for modern usage this includes TLS 1.2 only Some considerations: - The TLS ciphers and protocols available in each TLS policy follow industry recommendations, and may be updated occasionally. - The `compatible` TLS policy is no longer supported. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.update("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — The id of the custom domain to update </dd> </dl> <dl> <dd> **request:** `Management.UpdateCustomDomainRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">test</a>(id) -> Management.TestCustomDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Run the test process on a custom domain. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.test("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the custom domain to test. </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.customDomains.<a href="/src/management/api/resources/customDomains/client/Client.ts">verify</a>(id) -> Management.VerifyCustomDomainResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Run the verification process on a custom domain. Note: Check the `status` field to see its verification status. Once verification is complete, it may take up to 10 minutes before the custom domain can start accepting requests. For `self_managed_certs`, when the custom domain is verified for the first time, the response will also include the `cname_api_key` which you will need to configure your proxy. This key must be kept secret, and is used to validate the proxy requests. [Learn more](https://auth0.com/docs/custom-domains#step-2-verify-ownership) about verifying custom domains that use Auth0 Managed certificates. [Learn more](https://auth0.com/docs/custom-domains/self-managed-certificates#step-2-verify-ownership) about verifying custom domains that use Self Managed certificates. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.customDomains.verify("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the custom domain to verify. </dd> </dl> <dl> <dd> **requestOptions:** `CustomDomainsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## DeviceCredentials <details><summary><code>client.deviceCredentials.<a href="/src/management/api/resources/deviceCredentials/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;Management.DeviceCredential, Management.ListDeviceCredentialsOffsetPaginatedResponseContent&gt;</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Retrieve device credential information (`public_key`, `refresh_token`, or `rotating_refresh_token`) associated with a specific user. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript const pageableResponse = await client.deviceCredentials.list({ page: 1, per_page: 1, include_totals: true, fields: "fields", include_fields: true, user_id: "user_id", client_id: "client_id", type: "public_key", }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.deviceCredentials.list({ page: 1, per_page: 1, include_totals: true, fields: "fields", include_fields: true, user_id: "user_id", client_id: "client_id", type: "public_key", }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.ListDeviceCredentialsRequestParameters` </dd> </dl> <dl> <dd> **requestOptions:** `DeviceCredentialsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.deviceCredentials.<a href="/src/management/api/resources/deviceCredentials/client/Client.ts">createPublicKey</a>({ ...params }) -> Management.CreatePublicKeyDeviceCredentialResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create a device credential public key to manage refresh token rotation for a given `user_id`. Device Credentials APIs are designed for ad-hoc administrative use only and paging is by default enabled for GET requests. When refresh token rotation is enabled, the endpoint becomes consistent. For more information, read [Signing Keys](https://auth0.com/docs/get-started/tenant-settings/signing-keys). </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.deviceCredentials.createPublicKey({ device_name: "device_name", type: "public_key", value: "value", device_id: "device_id", }); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **request:** `Management.CreatePublicKeyDeviceCredentialRequestContent` </dd> </dl> <dl> <dd> **requestOptions:** `DeviceCredentialsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> <details><summary><code>client.deviceCredentials.<a href="/src/management/api/resources/deviceCredentials/client/Client.ts">delete</a>(id) -> void</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Permanently delete a device credential (such as a refresh token or public key) with the given ID. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript await client.deviceCredentials.delete("id"); ``` </dd> </dl> </dd> </dl> #### ⚙️ Parameters <dl> <dd> <dl> <dd> **id:** `string` — ID of the credential to delete. </dd> </dl> <dl> <dd> **requestOptions:** `DeviceCredentialsClient.RequestOptions` </dd> </dl> </dd> </dl> </dd> </dl> </details> ## EmailTemplates <details><summary><code>client.emailTemplates.<a href="/src/management/api/resources/emailTemplates/client/Client.ts">create</a>({ ...params }) -> Management.CreateEmailTemplateResponseContent</code></summary> <dl> <dd> #### 📝 Description <dl> <dd> <dl> <dd> Create an email template. </dd> </dl> </dd> </dl> #### 🔌 Usage <dl> <dd> <dl> <dd> ```typescript