Table of Contents

Interface IClientsClient

Namespace
Auth0.ManagementApi
Assembly
Auth0.ManagementApi.dll
public interface IClientsClient
Extension Methods

Properties

Connections 

IConnectionsClient Connections { get; }

Property Value

IConnectionsClient

Credentials 

ICredentialsClient Credentials { get; }

Property Value

ICredentialsClient

Methods

CreateAsync(CreateClientRequestContent, RequestOptions?, CancellationToken) 

WithRawResponseTask<CreateClientResponseContent> CreateAsync(CreateClientRequestContent request, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

request CreateClientRequestContent
options RequestOptions
cancellationToken CancellationToken

Returns

WithRawResponseTask<CreateClientResponseContent>

DeleteAsync(string, RequestOptions?, CancellationToken)

Delete a client and related configuration (rules, connections, etc).

Task DeleteAsync(string id, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

id string
options RequestOptions
cancellationToken CancellationToken

Returns

Task

GetAsync(string, GetClientRequestParameters, RequestOptions?, CancellationToken)

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 and 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. 
WithRawResponseTask<GetClientResponseContent> GetAsync(string id, GetClientRequestParameters request, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

id string
request GetClientRequestParameters
options RequestOptions
cancellationToken CancellationToken

Returns

WithRawResponseTask<GetClientResponseContent>

ListAsync(ListClientsRequestParameters, RequestOptions?, CancellationToken)

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 and 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. 
Task<Pager<Client>> ListAsync(ListClientsRequestParameters request, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

request ListClientsRequestParameters
options RequestOptions
cancellationToken CancellationToken

Returns

Task<Pager<Client>>

RotateSecretAsync(string, RequestOptions?, CancellationToken)

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.

WithRawResponseTask<RotateClientSecretResponseContent> RotateSecretAsync(string id, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

id string
options RequestOptions
cancellationToken CancellationToken

Returns

WithRawResponseTask<RotateClientSecretResponseContent>

UpdateAsync(string, UpdateClientRequestContent, RequestOptions?, CancellationToken)

Updates a client's settings. For more information, read Applications in Auth0 and 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.
WithRawResponseTask<UpdateClientResponseContent> UpdateAsync(string id, UpdateClientRequestContent request, RequestOptions? options = null, CancellationToken cancellationToken = default)

Parameters

id string
request UpdateClientRequestContent
options RequestOptions
cancellationToken CancellationToken

Returns

WithRawResponseTask<UpdateClientResponseContent>