openapi: 3.0.0 info: title: Auth0 Authentication actions connections API description: Auth0 Authentication API. Endpoints for authentication and authorization using OpenID Connect, OAuth 2.0, SAML, WS-Federation, and Passwordless flows. version: 1.0.0 servers: - url: '{auth0_domain}' description: The Authentication API is served over HTTPS. variables: auth0_domain: description: Auth0 domain default: https://demo.us.auth0.com tags: - name: connections paths: /connections: get: summary: Get All Connections description: "Retrieves detailed list of all connections 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. \n\nThis endpoint supports two types of pagination:\n
from: Optional id from which to start selection.take: The total amount of entries to retrieve when using the from parameter. Defaults to 50.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.\n"
tags:
- connections
parameters:
- name: per_page
in: query
description: The amount of entries per page. Defaults to 100 if not provided
schema:
type: integer
minimum: 1
maximum: 100
- name: page
in: query
description: The page number. Zero based
schema:
type: integer
minimum: 0
- name: include_totals
in: query
description: true if a query summary must be included in the result, false otherwise. Not returned when using checkpoint pagination. Default false.
schema:
type: boolean
- name: from
in: query
description: Optional Id from which to start selection.
schema:
type: string
- name: take
in: query
description: Number of results per page. Defaults to 50.
schema:
type: integer
minimum: 1
maximum: 100
- name: strategy
in: query
description: Provide strategies to only retrieve connections with such strategies
style: form
explode: true
schema:
type: array
items:
$ref: '#/components/schemas/ConnectionStrategyEnum'
- name: name
in: query
description: Provide the name of the connection to retrieve
schema:
type: string
- name: fields
in: query
description: A comma separated list of fields to include or exclude (depending on include_fields) from the result, empty to retrieve all fields
schema:
type: string
pattern: ^((name)|(display_name)|(strategy)|(options)|(id)|(provisioning_ticket_url)|(metadata)|(show_as_button)|(clients)|(authentication)|(connected_accounts)|(cross_app_access_requesting_app)|(cross_app_access_resource_app)|(enabled_clients))(,((name)|(display_name)|(strategy)|(options)|(id)|(provisioning_ticket_url)|(metadata)|(show_as_button)|(clients)|(authentication)|(connected_accounts)|(cross_app_access_requesting_app)|(cross_app_access_resource_app)|(enabled_clients)))*$
- name: include_fields
in: query
description: true if the fields specified are to be included in the result, false otherwise (defaults to true)
schema:
type: boolean
responses:
'200':
description: The connections were retrieved.
content:
application/json:
schema:
$ref: '#/components/schemas/ListConnectionsResponseContent'
'400':
description: Invalid request query string. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: read:connections'
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_connections
x-release-lifecycle: GA
x-operation-name: list
x-operation-request-parameters-name: ListConnectionsQueryParameters
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:connections
post:
summary: Create a Connection
description: '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. '
tags:
- connections
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConnectionRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/CreateConnectionRequestContent'
responses:
'201':
description: The connection was created.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConnectionResponseContent'
'400':
description: Invalid request body. The message will vary depending on the cause.
x-description-1: Your account is not allowed to set options.set_user_root_attributes
x-description-2: options.set_user_root_attributes can be set only for enterprise connections, social connections or custom database connections (using external users store)
x-description-3: No phone provider configured for the tenant
x-description-4: Passwordless connection cannot be made as delivery method (sms/text) is not supported by the configured Tenant phone provider
x-description-5: custom_password_hash option cannot be set because the universal password hash feature is not enabled for this tenant
x-description-6: The custom_password_hash option is only available for database connections
x-description-7: The action_id field value cannot be empty, null or undefined
x-description-8: The provided custom password hash action id does not exist
x-description-9: The provided action does not support the password hash migration trigger
x-description-10: The provided action must be deployed to be used for password hash migration
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: create:connections'
x-description-1: You reached the limit of entities of this type for this tenant.
x-description-2: You can only create 1 non-Okta enterprise connection(s) for this tenant.
'409':
description: A connection with the same name already exists
x-description-1: A connection with the same name is being deleted, try again later
x-description-2: There is already another connection with some realms from "realms" parameter
x-description-3: There is already a domain connection enabled for strategy
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: post_connections
x-release-lifecycle: GA
x-operation-name: create
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:connections
/connections/{id}:
get:
summary: Get a Connection
description: Retrieve details for a specified connection along with options that can be used for identity provider configuration.
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve
required: true
schema:
type: string
- name: fields
in: query
description: A comma separated list of fields to include or exclude (depending on include_fields) from the result, empty to retrieve all fields
schema:
type: string
pattern: ^((name)|(display_name)|(strategy)|(options)|(id)|(provisioning_ticket_url)|(metadata)|(show_as_button)|(clients)|(authentication)|(connected_accounts)|(cross_app_access_requesting_app)|(cross_app_access_resource_app)|(enabled_clients))(,((name)|(display_name)|(strategy)|(options)|(id)|(provisioning_ticket_url)|(metadata)|(show_as_button)|(clients)|(authentication)|(connected_accounts)|(cross_app_access_requesting_app)|(cross_app_access_resource_app)|(enabled_clients)))*$
- name: include_fields
in: query
description: true if the fields specified are to be included in the result, false otherwise (defaults to true)
schema:
type: boolean
responses:
'200':
description: The connection was retrieved.
content:
application/json:
schema:
$ref: '#/components/schemas/GetConnectionResponseContent'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Invalid request query string. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: read:connections'
'404':
description: The connection does not exist.
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_connections_by_id
x-release-lifecycle: GA
x-operation-name: get
x-operation-request-parameters-name: GetConnectionRequestParameters
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:connections
delete:
summary: Delete a Connection
description: 'Removes a specific connection 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 requests, if they use an identical connection name. '
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to delete
required: true
schema:
type: string
responses:
'202':
description: The connection is being deleted.
'204':
description: The connection no longer exists.
'400':
description: Invalid request URI. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: delete:connections'
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: delete_connections_by_id
x-release-lifecycle: GA
x-operation-name: delete
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- delete:connections
patch:
summary: Update a Connection
description: 'Update details for a specific connection, including option properties for identity provider configuration.
Note: If you use the options parameter, the entire options object is overriden. To avoid partial data or other issues, ensure all parameters are present when using this option.'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to update
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateConnectionRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/UpdateConnectionRequestContent'
responses:
'200':
description: The connection was updated.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateConnectionResponseContent'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Invalid request body. The message will vary depending on the cause.
x-description-2: This database contains users. You cannot change "options.enabledDatabaseCustomization" setting.
x-description-3: Your account is not allowed to set options.set_user_root_attributes
x-description-4: The Azure AD common endpoint cannot be enabled for this connection when SCIM is enabled.
x-description-5: The Google Workspace Users API (options.api_enable_users) cannot be disabled for this connection when inbound directory provisioning is enabled.
x-description-6: The Groups extended attribute (options.ext_groups) cannot be disabled for this connection when inbound directory provisioning for groups is enabled.
x-description-7: options.set_user_root_attributes can be set only for enterprise connections, social connections or custom database connections (using external users store)
x-description-8: custom_password_hash option cannot be set because the universal password hash feature is not enabled for this tenant
x-description-9: The custom_password_hash option is only available for database connections
x-description-10: The action_id field value cannot be empty, null or undefined
x-description-11: The provided custom password hash action id does not exist
x-description-12: The provided action does not support the password hash migration trigger
x-description-13: The provided action must be deployed to be used for password hash migration
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: update:connections'
'404':
description: The connection does not exist
'409':
description: The name/client_id tuple has already been used for another connection
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: patch_connections_by_id
x-release-lifecycle: GA
x-operation-name: update
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- update:connections
/connections/{id}/clients:
get:
summary: Get Enabled Clients for a Connection
description: 'Retrieve all clients that have the specified connection enabled.
Note: The first time you call this endpoint, 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 further results are remaining.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection for which enabled clients are to be retrieved
required: true
schema:
type: string
- name: take
in: query
description: Number of results per page. Defaults to 50.
schema:
type: integer
minimum: 1
maximum: 1000
- name: from
in: query
description: Optional Id from which to start selection.
schema:
type: string
maxLength: 1000
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetConnectionEnabledClientsResponseContent'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Invalid query string. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: read:connections'
'404':
description: The connection does not exist
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_connection_clients
x-release-lifecycle: GA
x-operation-name: get
x-operation-request-parameters-name: GetConnectionEnabledClientsRequestParameters
x-operation-group:
- connections
- clients
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:connections
patch:
summary: Update Enabled Clients for a Connection
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to modify
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateEnabledClientConnectionsRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/UpdateEnabledClientConnectionsRequestContent'
responses:
'204':
description: Success
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Invalid request body. The message will vary depending on the cause.
x-description-2: Tenant Phone Provider not set. Connection can not be enable on a client.
x-description-3: Passwordless cannot be enabled for a client, as delivery method (sms/text) is not supported by the configured Tenant phone provider
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: update:connections'
'404':
description: The connection does not exist
x-description-1: The client does not exist
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: patch_clients
x-release-lifecycle: GA
x-operation-name: update
x-operation-group:
- connections
- clients
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- update:connections
/connections/{id}/directory-provisioning:
get:
summary: Get a Directory Provisioning Configuration
description: Retrieve the directory provisioning configuration of a connection.
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve its directory provisioning configuration
required: true
schema:
type: string
responses:
'200':
description: The connection's directory provisioning configuration. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/GetDirectoryProvisioningResponseContent'
'400':
description: Path validation error
x-description-1: The connection strategy does not support inbound directory provisioning
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: The inbound directory provisioning feature is not enabled for this tenant
x-description-1: 'Insufficient scope; expected any of: read:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Directory provisioning configuration not found
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_directory-provisioning
x-release-lifecycle: GA
x-operation-name: get
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:directory_provisionings
delete:
summary: Delete a Directory Provisioning Configuration
description: Delete the directory provisioning configuration of a connection.
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to delete its directory provisioning configuration
required: true
schema:
type: string
responses:
'204':
description: The connection's directory provisioning configuration has been deleted.
'400':
description: Path validation error
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: The inbound directory provisioning feature is not enabled for this tenant
x-description-1: 'Insufficient scope; expected any of: delete:directory_provisionings.'
'404':
description: The connection does not exist
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: delete_directory-provisioning
x-release-lifecycle: GA
x-operation-name: delete
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- delete:directory_provisionings
patch:
summary: Patch a Directory Provisioning Configuration
description: 'Update the directory provisioning configuration of a connection.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to create its directory provisioning configuration
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDirectoryProvisioningRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/UpdateDirectoryProvisioningRequestContent'
responses:
'200':
description: The connection's directory provisioning configuration was updated. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDirectoryProvisioningResponseContent'
'400':
description: Path validation error
x-description-1: Payload validation error
x-description-2: Invalid mapping provided
x-description-3: The connection strategy does not support inbound directory provisioning
x-description-4: The connection cannot be synchronized because setup is incomplete. Please complete the Google Workspace connection administrator setup and try again.
x-description-5: The Groups extended attribute is not enabled on the connection. Select the Groups extended attribute option and go through the setup again.
x-description-6: The Google Workspace Groups API is not enabled on the connection. Select the Enable Groups API option and go through the setup again.
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: The inbound directory provisioning feature is not enabled for this tenant
x-description-1: Group synchronization is not enabled for this tenant
x-description-2: 'Insufficient scope; expected any of: update:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Directory provisioning configuration not found
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: patch_directory-provisioning
x-release-lifecycle: GA
x-operation-name: update
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- update:directory_provisionings
post:
summary: Create a Directory Provisioning Configuration
description: 'Create a directory provisioning configuration for a connection.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to create its directory provisioning configuration
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDirectoryProvisioningRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/CreateDirectoryProvisioningRequestContent'
responses:
'201':
description: The connection's directory provisioning configuration was created. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDirectoryProvisioningResponseContent'
'400':
description: Path validation error
x-description-1: Payload validation error
x-description-2: Invalid mapping provided
x-description-3: The connection strategy does not support inbound directory provisioning
x-description-4: The Google Workspace Users API is not enabled on the connection. Select the Enable Users API option and go through the setup again.
x-description-5: The connection cannot be synchronized because setup is incomplete. Please complete the Google Workspace connection administrator setup and try again.
x-description-6: The Groups extended attribute is not enabled on the connection. Select the Groups extended attribute option and go through the setup again.
x-description-7: The Google Workspace Groups API is not enabled on the connection. Select the Enable Groups API option and go through the setup again.
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: The inbound directory provisioning feature is not enabled for this tenant
x-description-1: Group synchronization is not enabled for this tenant
x-description-2: 'Insufficient scope; expected any of: create:directory_provisionings.'
'404':
description: The connection does not exist
'409':
description: Directory provisioning is already enabled on the specified connection
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: post_directory-provisioning
x-release-lifecycle: GA
x-operation-name: create
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:directory_provisionings
/connections/{id}/directory-provisioning/default-mapping:
get:
summary: Get a Connection's Default Directory Provisioning Attribute Mapping
description: 'Retrieve the directory provisioning default attribute mapping of a connection.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve its directory provisioning configuration
required: true
schema:
type: string
responses:
'200':
description: The connection's directory provisioning default mapping. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/GetDirectoryProvisioningDefaultMappingResponseContent'
'400':
description: Path validation error
x-description-1: The connection strategy does not support inbound directory provisioning
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: The inbound directory provisioning feature is not enabled for this tenant
x-description-1: 'Insufficient scope; expected any of: read:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Directory provisioning configuration not found
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_directory_provisioning_default_mapping
x-release-lifecycle: GA
x-operation-name: getDefaultMapping
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:directory_provisionings
/connections/{id}/directory-provisioning/synchronizations:
post:
summary: Request an On-demand Synchronization of the Directory
description: 'Request an on-demand synchronization of the directory.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to trigger synchronization for
required: true
schema:
type: string
responses:
'201':
description: The directory synchronization was triggered. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDirectorySynchronizationResponseContent'
'400':
description: Path validation error
x-description-1: Connection has been synchronized in the last 30 minutes. Please wait before synchronizing it again.
x-description-2: The connection cannot be synchronized because setup is incomplete. Please complete the Google Workspace connection administrator setup and try again.
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: 'Insufficient scope; expected any of: create:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Directory provisioning configuration not found
'409':
description: A synchronization has already been requested or is in progress for the connection
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: post_synchronizations
x-release-lifecycle: GA
x-operation-name: create
x-operation-group:
- connections
- directoryProvisioning
- synchronizations
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:directory_provisionings
/connections/{id}/directory-provisioning/synchronized-groups:
get:
summary: Get Synchronized Groups for a Directory Provisioning Configuration
description: 'Retrieve the configured synchronized groups for a connection directory provisioning configuration.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to list synchronized groups for.
required: true
schema:
type: string
- name: from
in: query
description: Optional Id from which to start selection.
schema:
type: string
- name: take
in: query
description: Number of results per page. Defaults to 50.
schema:
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: The connection's synchronized groups. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/ListSynchronizedGroupsResponseContent'
'400':
description: Path validation error
x-description-1: The Google Workspace Groups API is not enabled on the connection. Select the Enable Groups API option and go through the setup again.
x-description-2: The connection cannot be synchronized because setup is incomplete. Please complete the Google Workspace connection administrator setup and try again.
x-description-3: The pagination token has expired.
x-description-4: Invalid request query string. The message will vary depending on the cause.
x-description-5: Invalid query string paging options. The message will vary depending on the cause
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: Synchronized groups selection is not enabled for this tenant
x-description-1: Group synchronization is not enabled for this tenant
x-description-2: The inbound directory provisioning feature is not enabled for this tenant
x-description-3: 'Insufficient scope; expected any of: read:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Connection directory provisioning configuration not found
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_synchronized-groups
x-release-lifecycle: EA
x-operation-name: listSynchronizedGroups
x-operation-request-parameters-name: ListSynchronizedGroupsRequestParameters
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:directory_provisionings
put:
summary: Create or Replace Synchronized Group Selections for a Directory Provisioning Configuration
description: 'Create or replace the selected groups for a connection directory provisioning configuration.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to create or replace synchronized groups for
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ReplaceSynchronizedGroupsRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/ReplaceSynchronizedGroupsRequestContent'
responses:
'204':
description: No Content
'400':
description: Path validation error
x-description-1: Payload validation error
x-description-2: The Google Workspace Groups API is not enabled on the connection. Select the Enable Groups API option and go through the setup again.
x-description-3: The connection cannot be synchronized because setup is incomplete. Please complete the Google Workspace connection administrator setup and try again.
'401':
description: Invalid token.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Client is not global.
'403':
description: Synchronized groups selection is not enabled for this tenant
x-description-1: Group synchronization is not enabled for this tenant
x-description-2: The inbound directory provisioning feature is not enabled for this tenant
x-description-3: 'Insufficient scope; expected any of: update:directory_provisionings.'
'404':
description: The connection does not exist
x-description-1: Connection directory provisioning configuration not found
'409':
description: Conflict
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: put_synchronized-groups
x-release-lifecycle: EA
x-operation-name: set
x-operation-group:
- connections
- directoryProvisioning
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- update:directory_provisionings
/connections/{id}/keys:
get:
summary: Get Connection Keys
description: 'Gets the connection keys for the Okta or OIDC connection strategy.
'
tags:
- connections
parameters:
- name: id
in: path
description: ID of the connection
required: true
schema:
type: string
responses:
'200':
description: Connection keys successfully retrieved.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ConnectionKey'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: keys are not available for this connection
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation.
'403':
description: 'Insufficient scope; expected any of: read:connections_keys.'
'404':
description: Connection not found.
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_keys
x-release-lifecycle: GA
x-operation-name: get
x-operation-group:
- connections
- keys
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:connections_keys
post:
summary: Create Connection Keys
description: 'Provision initial connection keys for Okta or OIDC connection strategies. This endpoint allows you to create keys before configuring the connection to use Private Key JWT authentication, enabling zero-downtime transitions.
'
tags:
- connections
parameters:
- name: id
in: path
description: ID of the connection
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PostConnectionKeysRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/PostConnectionKeysRequestContent'
responses:
'201':
description: Connection keys successfully created.
content:
application/json:
schema:
$ref: '#/components/schemas/PostConnectionsKeysResponseContent'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Invalid request body. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation.
'403':
description: 'Insufficient scope; expected any of: create:connections_keys.'
'404':
description: Connection not found.
'409':
description: Keys have already been created for this connection.
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: post_keys
x-release-lifecycle: GA
x-operation-name: create
x-operation-group:
- connections
- keys
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:connections_keys
/connections/{id}/keys/rotate:
post:
summary: Rotate Connection Keys
description: 'Rotates the connection keys for the Okta or OIDC connection strategies.
'
tags:
- connections
parameters:
- name: id
in: path
description: ID of the connection
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RotateConnectionKeysRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/RotateConnectionKeysRequestContent'
responses:
'201':
description: Connection keys successfully rotated.
content:
application/json:
schema:
$ref: '#/components/schemas/RotateConnectionsKeysResponseContent'
'400':
description: Invalid request URI. The message will vary depending on the cause.
x-description-1: Key rotation is not supported on this connection
x-description-2: Connection is not configured to use JWT Client Authentication
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation.
'403':
description: 'Insufficient scope; expected all of: create:connections_keys, update:connections_keys.'
'404':
description: Connection not found.
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: post_rotate
x-release-lifecycle: GA
x-operation-name: rotate
x-operation-group:
- connections
- keys
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:connections_keys
- update:connections_keys
/connections/{id}/scim-configuration:
get:
summary: Get a Connection's SCIM Configuration
description: 'Retrieves a scim configuration by its connectionId.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve its SCIM configuration
required: true
schema:
type: string
responses:
'200':
description: The connection's SCIM configuration was retrieved. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/GetScimConfigurationResponseContent'
'400':
description: Path validation error
'404':
description: The connection does not exist
x-description-1: Not Found
operationId: get_scim-configuration
x-release-lifecycle: GA
x-operation-name: get
x-operation-group:
- connections
- scimConfiguration
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:scim_config
delete:
summary: Delete a Connection's SCIM Configuration
description: 'Deletes a scim configuration by its connectionId.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to delete its SCIM configuration
required: true
schema:
type: string
responses:
'204':
description: The connection's SCIM configuration has been deleted.
'400':
description: Path validation error
'404':
description: The connection does not exist
operationId: delete_scim-configuration
x-release-lifecycle: GA
x-operation-name: delete
x-operation-group:
- connections
- scimConfiguration
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- delete:scim_config
patch:
summary: Patch a Connection's SCIM Configuration
description: 'Update a scim configuration by its connectionId.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to update its SCIM configuration
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateScimConfigurationRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/UpdateScimConfigurationRequestContent'
responses:
'200':
description: The connection's SCIM configuration was updated. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateScimConfigurationResponseContent'
'400':
description: Invalid mapping provided
x-description-1: Invalid payload
x-description-2: Path validation error
'404':
description: The connection does not exist
operationId: patch_scim-configuration
x-release-lifecycle: GA
x-operation-name: update
x-operation-group:
- connections
- scimConfiguration
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- update:scim_config
post:
summary: Create a SCIM Configuration
description: 'Create a scim configuration for a connection.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to create its SCIM configuration
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateScimConfigurationRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/CreateScimConfigurationRequestContent'
responses:
'201':
description: The connection's SCIM configuration was created. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateScimConfigurationResponseContent'
'400':
description: Path validation error
x-description-1: SCIM configuration alreay exists for connection
x-description-2: Invalid mapping provided
x-description-3: Invalid payload
x-description-4: SCIM cannot be enabled for this connection when the Azure AD common endpoint is used.
'404':
description: The connection does not exist
operationId: post_scim-configuration
x-release-lifecycle: GA
x-operation-name: create
x-operation-group:
- connections
- scimConfiguration
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:scim_config
/connections/{id}/scim-configuration/default-mapping:
get:
summary: Get a Connection's Default SCIM Mapping
description: 'Retrieves a scim configuration''s default mapping by its connectionId.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve its default SCIM mapping
required: true
schema:
type: string
responses:
'200':
description: The connection's default SCIM mapping was retrieved. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/GetScimConfigurationDefaultMappingResponseContent'
'400':
description: Path validation error
'404':
description: Not Found
x-description-1: The connection does not exist
operationId: get_default-mapping
x-release-lifecycle: GA
x-operation-name: getDefaultMapping
x-operation-group:
- connections
- scimConfiguration
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:scim_config
/connections/{id}/scim-configuration/tokens:
get:
summary: Get a Connection's SCIM Tokens
description: 'Retrieves all scim tokens by its connection id.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to retrieve its SCIM configuration
required: true
schema:
type: string
responses:
'200':
description: The connection's SCIM tokens were retrieved. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/GetScimTokensResponseContent'
'400':
description: Path validation error
'404':
description: The connection does not exist
operationId: get_scim_tokens
x-release-lifecycle: GA
x-operation-name: get
x-operation-group:
- connections
- scimConfiguration
- tokens
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:scim_token
post:
summary: Create a SCIM Token
description: 'Create a scim token for a scim client.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection to create its SCIM token
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateScimTokenRequestContent'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/CreateScimTokenRequestContent'
responses:
'201':
description: The connection's SCIM token was created. See Response Schemas for schema.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateScimTokenResponseContent'
'400':
description: Path validation error
'404':
description: The connection does not exist
'409':
description: Maximum of 2 tokens already issued for this connection
operationId: post_scim_token
x-release-lifecycle: GA
x-operation-name: create
x-operation-group:
- connections
- scimConfiguration
- tokens
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- create:scim_token
/connections/{id}/scim-configuration/tokens/{tokenId}:
delete:
summary: Delete a Connection's SCIM Token
description: 'Deletes a scim token by its connection id and tokenId.
'
tags:
- connections
parameters:
- name: id
in: path
description: The connection id that owns the SCIM token to delete
required: true
schema:
type: string
- name: tokenId
in: path
description: The id of the scim token to delete
required: true
schema:
type: string
responses:
'204':
description: The SCIM token has been deleted.
'400':
description: Path validation error
'404':
description: The connection does not exist
operationId: delete_tokens_by_tokenId
x-release-lifecycle: GA
x-operation-name: delete
x-operation-group:
- connections
- scimConfiguration
- tokens
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- delete:scim_token
/connections/{id}/status:
get:
summary: Check Connection Status
description: 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
tags:
- connections
parameters:
- name: id
in: path
description: ID of the connection to check
required: true
schema:
type: string
responses:
'200':
description: Connection status successfully retrieved.
'400':
description: Invalid request URI. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation.
'403':
description: 'Insufficient scope; expected any of: read:connections.'
'404':
description: Connection not found.
x-description-1: not connected to any node
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: get_status
x-release-lifecycle: GA
x-operation-name: checkStatus
x-operation-group: connections
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:connections
/connections/{id}/users:
delete:
summary: Delete a Connection User
description: 'Deletes a specified connection user by its email (you cannot delete all users from specific connection). Currently, only Database Connections are supported.
'
tags:
- connections
parameters:
- name: id
in: path
description: The id of the connection (currently only database connections are supported)
required: true
schema:
type: string
- name: email
in: query
description: The email of the user to delete
required: true
schema:
type: string
responses:
'204':
description: The user no longer exists.
'400':
description: The connection does not exist
x-description-1: Connection must be a database connection
x-description-2: Invalid request URI. The message will vary depending on the cause.
'401':
description: Invalid token.
x-description-1: Client is not global.
x-description-2: Invalid signature received for JSON Web Token validation
'403':
description: 'Insufficient scope, expected any of: delete:users'
'429':
description: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
operationId: delete_users_by_email
x-release-lifecycle: GA
x-operation-name: deleteByEmail
x-operation-request-parameters-name: DeleteConnectionUsersByEmailQueryParameters
x-operation-group:
- connections
- users
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- delete:users
components:
schemas:
DefaultMethodEmailIdentifierEnum:
type: string
description: Default authentication method for email identifier
enum:
- password
- email_otp
x-release-lifecycle: EA
ConnectionSetUserRootAttributesEnum:
type: string
description: When using an external IdP, this flag determines whether 'name', 'given_name', 'family_name', 'nickname', and 'picture' attributes are updated. In addition, it also determines whether the user is created when user doesnt exist previously. Possible values are 'on_each_login' (default value, it configures the connection to automatically create the user if necessary and update the root attributes from the external IdP with each user login. When this setting is used, root attributes cannot be independently updated), 'on_first_login' (configures the connection to create the user and set the root attributes on first login only, allowing them to be independently updated thereafter), and 'never_on_login' (configures the connection not to create the user and not to set the root attributes from the external IdP, allowing them to be independently updated).
default: on_each_login
enum:
- on_each_login
- on_first_login
- never_on_login
SignupVerification:
type: object
additionalProperties: false
properties:
active:
type: boolean
ConnectionPasswordOptions:
type: object
description: Password policy options for flexible password policy configuration
additionalProperties: false
x-release-lifecycle: EA
properties:
complexity:
$ref: '#/components/schemas/ConnectionPasswordOptionsComplexity'
dictionary:
$ref: '#/components/schemas/ConnectionPasswordOptionsDictionary'
history:
$ref: '#/components/schemas/ConnectionPasswordOptionsHistory'
profile_data:
$ref: '#/components/schemas/ConnectionPasswordOptionsProfileData'
ConnectionTokenEndpointJwtcaAudFormatEnumOIDC:
type: string
description: 'Specifies the format of the aud (audience) claim included in the JWT used for client authentication at the token endpoint. Accepted values are: ''issuer'' (the aud claim is set to the OIDC issuer URL) or ''token_endpoint'' (the aud claim is set to the token endpoint URL).'
enum:
- issuer
- token_endpoint
x-merge-priority: -5
ListSynchronizedGroupsResponseContent:
type: object
additionalProperties: false
required:
- groups
properties:
groups:
type: array
description: Array of Google Workspace group ids configured for synchronization.
items:
$ref: '#/components/schemas/SynchronizedGroupPayload'
next:
type: string
description: The cursor to be used as the "from" query parameter for the next page of results.
ListConnectionsResponseContent:
oneOf:
- type: array
items:
$ref: '#/components/schemas/ConnectionForList'
- $ref: '#/components/schemas/ListConnectionsOffsetPaginatedResponseContent'
- $ref: '#/components/schemas/ListConnectionsCheckpointPaginatedResponseContent'
CreateDirectoryProvisioningResponseContent:
type: object
additionalProperties: false
required:
- connection_id
- connection_name
- strategy
- mapping
- synchronize_automatically
- created_at
- updated_at
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
synchronize_automatically:
type: boolean
description: Whether periodic automatic synchronization is enabled
synchronize_groups:
$ref: '#/components/schemas/SynchronizeGroupsEnum'
x-release-lifecycle: EA
created_at:
type: string
description: The timestamp at which the directory provisioning configuration was created
format: date-time
updated_at:
type: string
description: The timestamp at which the directory provisioning configuration was last updated
format: date-time
last_synchronization_at:
type: string
description: The timestamp at which the connection was last synchronized
format: date-time
last_synchronization_status:
type: string
description: The status of the last synchronization
last_synchronization_error:
type: string
description: The error message of the last synchronization, if any
ConnectionSignupBehaviorEnum:
type: string
description: Specifies the signup behavior for password authentication
enum:
- allow
- block
x-release-lifecycle: EA
ConnectionAttributes:
type: object
description: Attribute configuration
additionalProperties: false
minProperties: 1
properties:
email:
$ref: '#/components/schemas/EmailAttribute'
phone_number:
$ref: '#/components/schemas/PhoneAttribute'
username:
$ref: '#/components/schemas/UsernameAttribute'
CreateConnectionResponseContent:
type: object
additionalProperties: false
properties:
name:
type: string
description: The name of the connection
default: My connection
display_name:
type: string
description: Connection name used in login screen
options:
$ref: '#/components/schemas/ConnectionOptions'
id:
type: string
description: The connection's identifier
default: con_0000000000000001
strategy:
type: string
description: The type of the connection, related to the identity provider
default: auth0
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
enabled_clients:
type: array
description: DEPRECATED property. Use the GET /connections/:id/clients endpoint to get the ids of the clients for which the connection is enabled
x-release-lifecycle: deprecated
items:
type: string
description: The client id
is_domain_connection:
type: boolean
description: True if the connection is domain level
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD.
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
ConnectionEnabledClient:
type: object
additionalProperties: true
required:
- client_id
properties:
client_id:
type: string
description: The client id
ConnectionIdentifierPrecedenceEnum:
type: string
description: Order of precedence for attribute types
enum:
- email
- phone_number
- username
ConnectionUpstreamAliasEnum:
type: string
enum:
- acr_values
- audience
- client_id
- display
- id_token_hint
- login_hint
- max_age
- prompt
- resource
- response_mode
- response_type
- ui_locales
ConnectionPasswordOptionsProfileData:
type: object
description: Personal information restriction policy to prevent use of profile data in passwords
additionalProperties: false
properties:
active:
type: boolean
description: Prevents users from including profile data (like name, email) in their passwords
blocked_fields:
type: array
description: Blocked profile fields. An array of up to 12 entries.
items:
type: string
description: Blocked profile fields entry. 100 characters max.
maxLength: 100
CreateConnectionRequestContent:
type: object
additionalProperties: false
required:
- name
- strategy
properties:
name:
type: string
description: The name of the connection. Must start and end with an alphanumeric character and can only contain alphanumeric characters and '-'. Max length 128
maxLength: 128
pattern: ^[a-zA-Z0-9](-[a-zA-Z0-9]|[a-zA-Z0-9])*$
display_name:
type: string
description: Connection name used in the new universal login experience
maxLength: 128
strategy:
$ref: '#/components/schemas/ConnectionIdentityProviderEnum'
options:
$ref: '#/components/schemas/ConnectionPropertiesOptions'
enabled_clients:
type: array
description: Use of this property is NOT RECOMMENDED. Use the PATCH /v2/connections/{id}/clients endpoint to enable the connection for a set of clients.
items:
type: string
description: The id of the client for which the connection is to be enabled.
format: client-id
is_domain_connection:
type: boolean
description: true promotes to a domain-level connection so that third-party applications can use it. false does not promote the connection, so only first-party applications with the connection enabled can use it. (Defaults to false.)
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD. (Defaults to false.)
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
UpdateConnectionOptions:
type:
- object
- 'null'
description: The connection's options (depend on the connection strategy). To update these options, the `update:connections_options` scope must be present. To verify your changes, also include the `read:connections_options` scope. If this scope is not specified, you will not be able to review the updated object.
additionalProperties: true
properties:
validation:
$ref: '#/components/schemas/ConnectionValidationOptions'
non_persistent_attrs:
type:
- array
- 'null'
description: An array of user fields that should not be stored in the Auth0 database (https://auth0.com/docs/security/data-security/denylist)
items:
type: string
precedence:
type: array
description: Order of precedence for attribute types. If the property is not specified, the default precedence of attributes will be used.
minItems: 3
items:
$ref: '#/components/schemas/ConnectionIdentifierPrecedenceEnum'
attributes:
$ref: '#/components/schemas/ConnectionAttributes'
enable_script_context:
type: boolean
description: 'Set to true to inject context into custom DB scripts (warning: cannot be disabled once enabled)'
enabledDatabaseCustomization:
type: boolean
description: Set to true to use a legacy user store
import_mode:
type: boolean
description: Enable this if you have a legacy user store and you want to gradually migrate those users to the Auth0 user store
configuration:
type:
- object
- 'null'
description: Stores encrypted string only configurations for connections
additionalProperties:
type:
- string
- 'null'
customScripts:
$ref: '#/components/schemas/ConnectionCustomScripts'
authentication_methods:
$ref: '#/components/schemas/ConnectionAuthenticationMethods'
passkey_options:
$ref: '#/components/schemas/ConnectionPasskeyOptions'
passwordPolicy:
$ref: '#/components/schemas/ConnectionPasswordPolicyEnum'
password_complexity_options:
$ref: '#/components/schemas/ConnectionPasswordComplexityOptions'
password_history:
$ref: '#/components/schemas/ConnectionPasswordHistoryOptions'
password_no_personal_info:
$ref: '#/components/schemas/ConnectionPasswordNoPersonalInfoOptions'
password_dictionary:
$ref: '#/components/schemas/ConnectionPasswordDictionaryOptions'
api_enable_users:
type: boolean
api_enable_groups:
type: boolean
x-release-lifecycle: EA
basic_profile:
type: boolean
ext_admin:
type: boolean
ext_is_suspended:
type: boolean
ext_agreed_terms:
type: boolean
ext_groups:
type: boolean
ext_assigned_plans:
type: boolean
ext_profile:
type: boolean
disable_self_service_change_password:
type: boolean
upstream_params:
$ref: '#/components/schemas/ConnectionUpstreamParams'
set_user_root_attributes:
$ref: '#/components/schemas/ConnectionSetUserRootAttributesEnum'
gateway_authentication:
$ref: '#/components/schemas/ConnectionGatewayAuthentication'
federated_connections_access_tokens:
$ref: '#/components/schemas/ConnectionFederatedConnectionsAccessTokens'
password_options:
$ref: '#/components/schemas/ConnectionPasswordOptions'
x-release-lifecycle: EA
assertion_decryption_settings:
$ref: '#/components/schemas/ConnectionAssertionDecryptionSettings'
id_token_signed_response_algs:
$ref: '#/components/schemas/ConnectionIdTokenSignedResponseAlgs'
token_endpoint_auth_method:
$ref: '#/components/schemas/ConnectionTokenEndpointAuthMethodEnum'
token_endpoint_auth_signing_alg:
$ref: '#/components/schemas/ConnectionTokenEndpointAuthSigningAlgEnum'
token_endpoint_jwtca_aud_format:
$ref: '#/components/schemas/ConnectionTokenEndpointJwtcaAudFormatEnumOIDC'
GetScimConfigurationDefaultMappingResponseContent:
type: object
additionalProperties: false
properties:
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
SignupStatusEnum:
type: string
enum:
- required
- optional
- inactive
ConnectionForList:
type: object
additionalProperties: false
properties:
name:
type: string
description: The name of the connection
default: My connection
display_name:
type: string
description: Connection name used in login screen
options:
$ref: '#/components/schemas/ConnectionOptions'
id:
type: string
description: The connection's identifier
default: con_0000000000000001
strategy:
type: string
description: The type of the connection, related to the identity provider
default: auth0
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
is_domain_connection:
type: boolean
description: True if the connection is domain level
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD.
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
EmailAttribute:
type: object
description: Configuration for the email attribute for users.
additionalProperties: false
properties:
identifier:
$ref: '#/components/schemas/ConnectionAttributeIdentifier'
unique:
type: boolean
description: Determines if the attribute is unique in a given connection
profile_required:
type: boolean
description: Determines if property should be required for users
verification_method:
$ref: '#/components/schemas/VerificationMethodEnum'
signup:
$ref: '#/components/schemas/SignupVerified'
ConnectionUpstreamAlias:
type: object
additionalProperties: false
properties:
alias:
$ref: '#/components/schemas/ConnectionUpstreamAliasEnum'
SignupSchema:
type: object
additionalProperties: false
properties:
status:
$ref: '#/components/schemas/SignupStatusEnum'
ConnectionUsernameValidationOptions:
type:
- object
- 'null'
additionalProperties: false
required:
- max
- min
properties:
min:
type: integer
minimum: 1
max:
type: integer
maximum: 128
SynchronizedGroupPayload:
type: object
additionalProperties: false
required:
- id
properties:
id:
type: string
description: Google Workspace Directory group ID.
minLength: 1
maxLength: 32
pattern: ^[A-Za-z0-9]+$
UpdateScimConfigurationRequestContent:
type: object
additionalProperties: false
required:
- user_id_attribute
- mapping
properties:
user_id_attribute:
type: string
description: User ID attribute for generating unique user ids
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
PasswordDefaultDictionariesEnum:
type: string
description: 'Default dictionary to use for password validation. Options: "en_10k" (10,000 common words) or "en_100k" (100,000 common words)'
enum:
- en_10k
- en_100k
ScimTokenItem:
type: object
additionalProperties: true
properties:
token_id:
type: string
description: The token's identifier
scopes:
type: array
description: The scopes of the scim token
items:
type: string
description: The token's scope
created_at:
type: string
description: The token's created at timestamp
valid_until:
type: string
description: The token's valid until timestamp
last_used_at:
type: string
description: The token's last used at timestamp
SynchronizeGroupsEnum:
type: string
description: Group synchronization configuration
enum:
- all
- 'off'
- selected
x-release-lifecycle: EA
UpdateConnectionRequestContent:
type: object
additionalProperties: false
minProperties: 1
properties:
display_name:
type: string
description: The connection name used in the new universal login experience. If display_name is not included in the request, the field will be overwritten with the name value.
maxLength: 128
options:
$ref: '#/components/schemas/UpdateConnectionOptions'
enabled_clients:
type:
- array
- 'null'
description: DEPRECATED property. Use the PATCH /v2/connections/{id}/clients endpoint to enable or disable the connection for any clients.
x-release-lifecycle: deprecated
items:
type: string
description: The client_id of the client to for which the connection is to be enabled
format: client-id
is_domain_connection:
type: boolean
description: true promotes to a domain-level connection so that third-party applications can use it. false does not promote the connection, so only first-party applications with the connection enabled can use it. (Defaults to false.)
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD. (Defaults to false.)
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
UsernameValidation:
type: object
additionalProperties: false
properties:
min_length:
type: number
description: Minimum allowed length
minimum: 1
maximum: 128
max_length:
type: number
description: Maximum allowed length
minimum: 1
maximum: 128
allowed_types:
$ref: '#/components/schemas/UsernameAllowedTypes'
PostConnectionKeysRequestContent:
type:
- object
- 'null'
additionalProperties: false
properties:
signing_alg:
$ref: '#/components/schemas/PostConnectionKeysAlgEnum'
ConnectionUpstreamAdditionalProperties:
type: object
oneOf:
- $ref: '#/components/schemas/ConnectionUpstreamAlias'
- $ref: '#/components/schemas/ConnectionUpstreamValue'
ConnectionPasswordComplexityOptions:
type:
- object
- 'null'
description: Password complexity options
additionalProperties: false
properties:
min_length:
type: integer
description: Minimum password length
minimum: 1
maximum: 128
ConnectionAuthenticationMethods:
type:
- object
- 'null'
description: Options for enabling authentication methods.
additionalProperties: false
properties:
password:
$ref: '#/components/schemas/ConnectionPasswordAuthenticationMethod'
passkey:
$ref: '#/components/schemas/ConnectionPasskeyAuthenticationMethod'
email_otp:
$ref: '#/components/schemas/ConnectionEmailOtpAuthenticationMethod'
x-release-lifecycle: EA
phone_otp:
$ref: '#/components/schemas/ConnectionPhoneOtpAuthenticationMethod'
x-release-lifecycle: EA
ConnectionPasswordOptionsHistory:
type: object
description: Password history policy configuration to prevent password reuse
additionalProperties: false
properties:
active:
type: boolean
description: Enables password history checking to prevent users from reusing recent passwords
size:
type: integer
description: Number of previous passwords to remember and prevent reuse (1-24)
minimum: 1
maximum: 24
ConnectionEmailOtpAuthenticationMethod:
type: object
description: Email OTP authentication enablement
additionalProperties: false
x-release-lifecycle: EA
properties:
enabled:
type: boolean
description: Determines whether email OTP is enabled
ConnectionUpstreamValue:
type: object
additionalProperties: false
properties:
value:
type: string
ConnectionOptions:
type: object
description: In order to return options in the response, the `read:connections_options` scope must be present
additionalProperties: true
PostConnectionsKeysResponseContent:
type: array
items:
type: object
additionalProperties: true
required:
- cert
- kid
- fingerprint
- thumbprint
properties:
kid:
type: string
description: The key id of the signing key
maxLength: 255
cert:
type: string
description: The public certificate of the signing key
default: "-----BEGIN CERTIFICATE-----\r\nMIIDDTCCA...YiA0TQhAt8=\r\n-----END CERTIFICATE-----"
maxLength: 4096
pkcs:
type: string
description: The public certificate of the signing key in pkcs7 format
default: "-----BEGIN PKCS7-----\r\nMIIDPA....t8xAA==\r\n-----END PKCS7-----"
maxLength: 4096
current:
type: boolean
description: True if the key is the current key
default: true
next:
type: boolean
description: True if the key is the next key
current_since:
type: string
description: The date and time when the key became the current key
fingerprint:
type: string
description: The cert fingerprint
default: CC:FB:DD:D8:9A:B5:DE:1B:F0:CC:36:D2:99:59:21:12:03:DD:A8:25
thumbprint:
type: string
description: The cert thumbprint
default: CCFBDDD89AB5DE1BF0CC36D29959211203DDA825
maxLength: 255
algorithm:
type: string
description: Signing key algorithm
key_use:
$ref: '#/components/schemas/ConnectionKeyUseEnum'
subject_dn:
type: string
maxLength: 132
UsernameAttribute:
type: object
description: Configuration for the username attribute for users.
additionalProperties: false
properties:
identifier:
$ref: '#/components/schemas/ConnectionAttributeIdentifier'
profile_required:
type: boolean
description: Determines if property should be required for users
signup:
$ref: '#/components/schemas/SignupSchema'
validation:
$ref: '#/components/schemas/UsernameValidation'
ListConnectionsCheckpointPaginatedResponseContent:
type: object
additionalProperties: false
properties:
next:
type: string
description: Opaque identifier for use with the from query parameter for the next page of results.
connections:
type: array
items:
$ref: '#/components/schemas/ConnectionForList'
ConnectionAuthenticationPurpose:
type: object
description: Configure the purpose of a connection to be used for authentication during login.
additionalProperties: false
required:
- active
x-release-lifecycle: GA
properties:
active:
type: boolean
ConnectionTokenEndpointAuthMethodEnum:
type:
- string
- 'null'
description: Authentication method used at the identity provider's token endpoint. 'client_secret_post' sends credentials in the request body; 'private_key_jwt' uses a signed JWT assertion for enhanced security.
enum:
- client_secret_post
- private_key_jwt
x-merge-priority: -5
ConnectionPasskeyOptions:
type:
- object
- 'null'
description: Options for the passkey authentication method
additionalProperties: false
properties:
challenge_ui:
$ref: '#/components/schemas/ConnectionPasskeyChallengeUIEnum'
progressive_enrollment_enabled:
type: boolean
description: Enables or disables progressive enrollment of passkeys for the connection.
local_enrollment_enabled:
type: boolean
description: Enables or disables enrollment prompt for local passkey when user authenticates using a cross-device passkey for the connection.
UpdateEnabledClientConnectionsRequestContent:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- client_id
- status
properties:
client_id:
type: string
description: The client_id of the client whose status will be changed. Note that the limit per PATCH request is 50 clients.
format: client-id
status:
type: boolean
description: Whether the connection is enabled or not for this client_id
ConnectionAssertionDecryptionAlgorithmProfileEnum:
type: string
description: The algorithm profile to use for decrypting SAML assertions.
enum:
- v2026-1
CreateScimTokenRequestContent:
type: object
description: SCIM Token
additionalProperties: false
properties:
scopes:
type: array
description: The scopes of the scim token
minItems: 1
items:
type: string
description: The token's scope
token_lifetime:
type:
- integer
- 'null'
description: Lifetime of the token in seconds. Must be greater than 900
ConnectionPasswordNoPersonalInfoOptions:
type:
- object
- 'null'
description: Options for personal info in passwords policy
additionalProperties: false
required:
- enable
properties:
enable:
type: boolean
ConnectionIdTokenSignedResponseAlgEnum:
description: Algorithm allowed to verify the ID tokens.
type: string
enum:
- ES256
- ES384
- PS256
- PS384
- RS256
- RS384
- RS512
x-merge-priority: -5
PhoneAttribute:
type: object
description: Configuration for the phone number attribute for users.
additionalProperties: false
properties:
identifier:
$ref: '#/components/schemas/ConnectionAttributeIdentifier'
profile_required:
type: boolean
description: Determines if property should be required for users
signup:
$ref: '#/components/schemas/SignupVerified'
ConnectionValidationOptions:
type:
- object
- 'null'
description: Options for validation
additionalProperties: false
properties:
username:
$ref: '#/components/schemas/ConnectionUsernameValidationOptions'
ConnectionAssertionDecryptionSettings:
type: object
description: Settings for SAML assertion decryption.
additionalProperties: false
required:
- algorithm_profile
properties:
algorithm_profile:
$ref: '#/components/schemas/ConnectionAssertionDecryptionAlgorithmProfileEnum'
algorithm_exceptions:
type: array
description: A list of insecure algorithms to allow for SAML assertion decryption.
items:
type: string
minLength: 1
maxLength: 100
ListConnectionsOffsetPaginatedResponseContent:
type: object
additionalProperties: false
properties:
start:
type: number
limit:
type: number
total:
type: number
connections:
type: array
items:
$ref: '#/components/schemas/ConnectionForList'
ConnectionGatewayAuthentication:
type:
- object
- 'null'
description: Token-based authentication settings to be applied when connection is using an sms strategy.
additionalProperties: true
required:
- method
- audience
- secret
properties:
method:
type: string
description: The Authorization header type.
subject:
type: string
description: The subject to be added to the JWT payload.
audience:
type: string
description: The audience to be added to the JWT payload.
secret:
type: string
description: The secret to be used for signing tokens.
secret_base64_encoded:
type: boolean
description: Set to true if the provided secret is base64 encoded.
ConnectionKeyUseEnum:
type: string
description: Signing key use, whether for encryption or signing
enum:
- encryption
- signing
GetScimConfigurationResponseContent:
type: object
additionalProperties: false
required:
- tenant_name
- connection_id
- connection_name
- strategy
- created_at
- updated_on
- mapping
- user_id_attribute
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
tenant_name:
type: string
description: The tenant's name
user_id_attribute:
type: string
description: User ID attribute for generating unique user ids
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
created_at:
type: string
description: The ISO 8601 date and time the SCIM configuration was created at
format: date-time
updated_on:
type: string
description: The ISO 8601 date and time the SCIM configuration was last updated on
format: date-time
CreateScimTokenResponseContent:
type: object
additionalProperties: false
properties:
token_id:
type: string
description: The token's identifier
token:
type: string
description: The scim client's token
scopes:
type: array
description: The scopes of the scim token
items:
type: string
description: The token's scope
created_at:
type: string
description: The token's created at timestamp
valid_until:
type: string
description: The token's valid until at timestamp
ConnectionPhoneOtpAuthenticationMethod:
type: object
description: Phone OTP authentication enablement
additionalProperties: false
x-release-lifecycle: EA
properties:
enabled:
type: boolean
description: Determines whether phone OTP is enabled
ScimMappingItem:
type: object
additionalProperties: true
properties:
auth0:
type: string
description: The field location in the auth0 schema
scim:
type: string
description: The field location in the SCIM schema
SignupVerified:
type: object
additionalProperties: false
properties:
status:
$ref: '#/components/schemas/SignupStatusEnum'
verification:
$ref: '#/components/schemas/SignupVerification'
ConnectionFederatedConnectionsAccessTokens:
type:
- object
- 'null'
description: Federated Connections Access Tokens
additionalProperties: false
properties:
active:
type: boolean
description: Enables refresh tokens and access tokens collection for federated connections
ConnectionConnectedAccountsPurpose:
type: object
description: Configure the purpose of a connection to be used for connected accounts and Token Vault.
additionalProperties: false
required:
- active
x-release-lifecycle: GA
properties:
active:
type: boolean
cross_app_access:
type: boolean
GetScimTokensResponseContent:
type: array
description: The list of scim tokens for scim clients
items:
$ref: '#/components/schemas/ScimTokenItem'
ConnectionApiBehaviorEnum:
type: string
description: Specifies the API behavior for password authentication
enum:
- required
- optional
x-release-lifecycle: EA
ConnectionPasswordOptionsComplexity:
type: object
description: Password complexity requirements configuration
additionalProperties: false
properties:
min_length:
type: integer
description: Minimum password length required (1-72 characters)
minimum: 1
maximum: 72
character_types:
type: array
description: 'Required character types that must be present in passwords. Valid options: uppercase, lowercase, number, special'
items:
$ref: '#/components/schemas/PasswordCharacterTypeEnum'
character_type_rule:
$ref: '#/components/schemas/PasswordCharacterTypeRulePolicyEnum'
identical_characters:
$ref: '#/components/schemas/PasswordIdenticalCharactersPolicyEnum'
sequential_characters:
$ref: '#/components/schemas/PasswordSequentialCharactersPolicyEnum'
max_length_exceeded:
$ref: '#/components/schemas/PasswordMaxLengthExceededPolicyEnum'
ConnectionAttributeIdentifier:
type: object
additionalProperties: false
properties:
active:
type: boolean
description: Determines if the attribute is used for identification
default_method:
$ref: '#/components/schemas/DefaultMethodEmailIdentifierEnum'
x-release-lifecycle: EA
VerificationMethodEnum:
type: string
enum:
- link
- otp
CreateScimConfigurationRequestContent:
type:
- object
- 'null'
additionalProperties: false
properties:
user_id_attribute:
type: string
description: User ID attribute for generating unique user ids
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
RotateConnectionsKeysResponseContent:
type: object
additionalProperties: true
required:
- cert
- kid
- fingerprint
- thumbprint
properties:
kid:
type: string
description: The key id of the signing key
maxLength: 255
cert:
type: string
description: The public certificate of the signing key
default: "-----BEGIN CERTIFICATE-----\r\nMIIDDTCCA...YiA0TQhAt8=\r\n-----END CERTIFICATE-----"
maxLength: 4096
pkcs:
type: string
description: The public certificate of the signing key in pkcs7 format
default: "-----BEGIN PKCS7-----\r\nMIIDPA....t8xAA==\r\n-----END PKCS7-----"
maxLength: 4096
next:
type: boolean
description: True if the key is the the next key
fingerprint:
type: string
description: The cert fingerprint
default: CC:FB:DD:D8:9A:B5:DE:1B:F0:CC:36:D2:99:59:21:12:03:DD:A8:25
thumbprint:
type: string
description: The cert thumbprint
default: CCFBDDD89AB5DE1BF0CC36D29959211203DDA825
maxLength: 255
algorithm:
type: string
description: Signing key algorithm
key_use:
$ref: '#/components/schemas/ConnectionKeyUseEnum'
subject_dn:
type: string
maxLength: 132
UpdateDirectoryProvisioningRequestContent:
type:
- object
- 'null'
additionalProperties: false
properties:
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
synchronize_automatically:
type: boolean
description: Whether periodic automatic synchronization is enabled
synchronize_groups:
$ref: '#/components/schemas/SynchronizeGroupsEnum'
x-release-lifecycle: EA
ConnectionIdTokenSignedResponseAlgs:
description: List of algorithms allowed to verify the ID tokens.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ConnectionIdTokenSignedResponseAlgEnum'
x-merge-priority: -5
GetConnectionResponseContent:
type: object
additionalProperties: false
properties:
name:
type: string
description: The name of the connection
default: My connection
display_name:
type: string
description: Connection name used in login screen
options:
$ref: '#/components/schemas/ConnectionOptions'
id:
type: string
description: The connection's identifier
default: con_0000000000000001
strategy:
type: string
description: The type of the connection, related to the identity provider
default: auth0
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
enabled_clients:
type: array
description: DEPRECATED property. Use the GET /connections/:id/clients endpoint to get the ids of the clients for which the connection is enabled
x-release-lifecycle: deprecated
items:
type: string
description: The client id
is_domain_connection:
type: boolean
description: True if the connection is domain level
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD.
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
ConnectionCustomScripts:
type: object
description: A map of scripts used to integrate with a custom database.
additionalProperties: true
properties:
login:
type: string
minLength: 1
get_user:
type: string
minLength: 1
delete:
type: string
minLength: 1
change_password:
type: string
minLength: 1
verify:
type: string
minLength: 1
create:
type: string
minLength: 1
change_username:
type: string
minLength: 1
change_email:
type: string
minLength: 1
change_phone_number:
type: string
minLength: 1
ConnectionKey:
type: object
additionalProperties: true
required:
- cert
- kid
- fingerprint
- thumbprint
properties:
kid:
type: string
description: The key id of the signing key
maxLength: 255
cert:
type: string
description: The public certificate of the signing key
default: "-----BEGIN CERTIFICATE-----\r\nMIIDDTCCA...YiA0TQhAt8=\r\n-----END CERTIFICATE-----"
maxLength: 4096
pkcs:
type: string
description: The public certificate of the signing key in pkcs7 format
default: "-----BEGIN PKCS7-----\r\nMIIDPA....t8xAA==\r\n-----END PKCS7-----"
maxLength: 4096
current:
type: boolean
description: True if the key is the the current key
default: true
next:
type: boolean
description: True if the key is the the next key
previous:
type: boolean
description: True if the key is the the previous key
current_since:
type: string
description: The date and time when the key became the current key
fingerprint:
type: string
description: The cert fingerprint
default: CC:FB:DD:D8:9A:B5:DE:1B:F0:CC:36:D2:99:59:21:12:03:DD:A8:25
thumbprint:
type: string
description: The cert thumbprint
default: CCFBDDD89AB5DE1BF0CC36D29959211203DDA825
maxLength: 255
algorithm:
type: string
description: Signing key algorithm
key_use:
$ref: '#/components/schemas/ConnectionKeyUseEnum'
subject_dn:
type: string
maxLength: 132
UpdateConnectionResponseContent:
type: object
additionalProperties: false
properties:
name:
type: string
description: The name of the connection
default: My connection
display_name:
type: string
description: Connection name used in login screen
options:
$ref: '#/components/schemas/ConnectionOptions'
id:
type: string
description: The connection's identifier
default: con_0000000000000001
strategy:
type: string
description: The type of the connection, related to the identity provider
default: auth0
realms:
type: array
description: 'Defines the realms for which the connection will be used (ie: email domains). If the array is empty or the property is not specified, the connection name will be added as realm.'
items:
type: string
description: The realm where this connection belongs
format: connection-realm
enabled_clients:
type: array
description: DEPRECATED property. Use the GET /connections/:id/clients endpoint to get the ids of the clients for which the connection is enabled
x-release-lifecycle: deprecated
items:
type: string
description: The client id
is_domain_connection:
type: boolean
description: True if the connection is domain level
show_as_button:
type: boolean
description: Enables showing a button for the connection in the login page (new experience only). If false, it will be usable only by HRD.
metadata:
$ref: '#/components/schemas/ConnectionsMetadata'
authentication:
$ref: '#/components/schemas/ConnectionAuthenticationPurpose'
x-release-lifecycle: GA
connected_accounts:
$ref: '#/components/schemas/ConnectionConnectedAccountsPurpose'
x-release-lifecycle: GA
ConnectionIdentityProviderEnum:
type: string
description: The identity provider identifier for the connection
enum:
- ad
- adfs
- amazon
- apple
- dropbox
- bitbucket
- auth0-oidc
- auth0
- baidu
- bitly
- box
- custom
- daccount
- dwolla
- email
- evernote-sandbox
- evernote
- exact
- facebook
- fitbit
- github
- google-apps
- google-oauth2
- instagram
- ip
- line
- linkedin
- oauth1
- oauth2
- office365
- oidc
- okta
- paypal
- paypal-sandbox
- pingfederate
- planningcenter
- salesforce-community
- salesforce-sandbox
- salesforce
- samlp
- sharepoint
- shopify
- shop
- sms
- soundcloud
- thirtysevensignals
- twitter
- untappd
- vkontakte
- waad
- weibo
- windowslive
- wordpress
- yahoo
- yandex
CreateScimConfigurationResponseContent:
type: object
additionalProperties: false
required:
- tenant_name
- connection_id
- connection_name
- strategy
- created_at
- updated_on
- mapping
- user_id_attribute
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
tenant_name:
type: string
description: The tenant's name
user_id_attribute:
type: string
description: User ID attribute for generating unique user ids
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
created_at:
type: string
description: The ISO 8601 date and time the SCIM configuration was created at
format: date-time
updated_on:
type: string
description: The ISO 8601 date and time the SCIM configuration was last updated on
format: date-time
RotateConnectionKeysRequestContent:
type:
- object
- 'null'
additionalProperties: false
properties:
signing_alg:
$ref: '#/components/schemas/RotateConnectionKeysSigningAlgEnum'
RotateConnectionKeysSigningAlgEnum:
type: string
description: Selected Signing Algorithm
enum:
- RS256
- RS384
- RS512
- PS256
- PS384
- ES256
- ES384
ConnectionsMetadata:
type: object
description: Metadata associated with the connection in the form of an object with string values (max 255 chars). Maximum of 10 metadata properties allowed.
additionalProperties:
type:
- string
- 'null'
maxLength: 255
maxProperties: 10
ConnectionPasswordHistoryOptions:
type:
- object
- 'null'
description: Options for password history policy
additionalProperties: false
required:
- enable
properties:
enable:
type: boolean
size:
type: integer
minimum: 0
maximum: 24
ConnectionPasswordPolicyEnum:
type:
- string
- 'null'
description: Password strength level
enum:
- none
- low
- fair
- good
- excellent
- null
GetDirectoryProvisioningDefaultMappingResponseContent:
type: object
additionalProperties: false
properties:
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
ConnectionTokenEndpointAuthSigningAlgEnum:
type:
- string
- 'null'
description: Algorithm used to sign client_assertions.
enum:
- ES256
- ES384
- PS256
- PS384
- RS256
- RS384
- RS512
x-merge-priority: -5
DirectoryProvisioningMappingItem:
type: object
additionalProperties: false
required:
- auth0
- idp
properties:
auth0:
type: string
description: The field location in the Auth0 schema
idp:
type: string
description: The field location in the IDP schema
PasswordCharacterTypeRulePolicyEnum:
type: string
description: When enabled, passwords must contain at least 3 out of 4 character types. Can only be enabled when all 4 character types are specified
enum:
- all
- three_of_four
PasswordCharacterTypeEnum:
type: string
enum:
- uppercase
- lowercase
- number
- special
PasswordSequentialCharactersPolicyEnum:
type: string
description: Controls whether sequential characters are allowed in passwords
enum:
- allow
- block
ConnectionPasswordDictionaryOptions:
type:
- object
- 'null'
description: Options for password dictionary policy
additionalProperties: false
required:
- enable
properties:
enable:
type: boolean
dictionary:
type: array
description: Custom Password Dictionary. An array of up to 200 entries.
items:
type: string
description: Custom Password Dictionary entry. 50 characters max.
maxLength: 50
PasswordIdenticalCharactersPolicyEnum:
type: string
description: Controls whether identical consecutive characters are allowed in passwords
enum:
- allow
- block
ConnectionPasswordOptionsDictionary:
type: object
description: Dictionary-based password restriction policy to prevent common passwords
additionalProperties: false
properties:
active:
type: boolean
description: Enables dictionary checking to prevent use of common passwords and custom blocked words
custom:
type: array
description: Array of custom words to block in passwords. Maximum 200 items, each up to 50 characters
items:
type: string
maxLength: 50
default:
$ref: '#/components/schemas/PasswordDefaultDictionariesEnum'
UpdateScimConfigurationResponseContent:
type: object
additionalProperties: false
required:
- tenant_name
- connection_id
- connection_name
- strategy
- created_at
- updated_on
- mapping
- user_id_attribute
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
tenant_name:
type: string
description: The tenant's name
user_id_attribute:
type: string
description: User ID attribute for generating unique user ids
mapping:
type: array
description: The mapping between auth0 and SCIM
items:
$ref: '#/components/schemas/ScimMappingItem'
created_at:
type: string
description: The ISO 8601 date and time the SCIM configuration was created at
format: date-time
updated_on:
type: string
description: The ISO 8601 date and time the SCIM configuration was last updated on
format: date-time
ConnectionPasswordAuthenticationMethod:
type: object
description: Password authentication enablement
additionalProperties: false
properties:
enabled:
type: boolean
description: Determines whether passwords are enabled
api_behavior:
$ref: '#/components/schemas/ConnectionApiBehaviorEnum'
x-release-lifecycle: EA
signup_behavior:
$ref: '#/components/schemas/ConnectionSignupBehaviorEnum'
x-release-lifecycle: EA
ConnectionPasskeyAuthenticationMethod:
type: object
description: Passkey authentication enablement
additionalProperties: false
properties:
enabled:
type: boolean
description: Determines whether passkeys are enabled
ConnectionPasskeyChallengeUIEnum:
type: string
description: Controls the UI used to challenge the user for their passkey.
enum:
- both
- autofill
- button
ConnectionUpstreamParams:
type:
- object
- 'null'
description: Options for adding parameters in the request to the upstream IdP
additionalProperties:
$ref: '#/components/schemas/ConnectionUpstreamAdditionalProperties'
GetConnectionEnabledClientsResponseContent:
type: object
additionalProperties: true
required:
- clients
properties:
clients:
type: array
description: Clients for which the connection is enabled
items:
$ref: '#/components/schemas/ConnectionEnabledClient'
next:
type: string
description: Encoded next token
ConnectionPropertiesOptions:
type: object
description: The connection's options (depend on the connection strategy)
additionalProperties: true
properties:
validation:
$ref: '#/components/schemas/ConnectionValidationOptions'
non_persistent_attrs:
type:
- array
- 'null'
description: An array of user fields that should not be stored in the Auth0 database (https://auth0.com/docs/security/data-security/denylist)
items:
type: string
precedence:
type: array
description: Order of precedence for attribute types. If the property is not specified, the default precedence of attributes will be used.
minItems: 3
items:
$ref: '#/components/schemas/ConnectionIdentifierPrecedenceEnum'
attributes:
$ref: '#/components/schemas/ConnectionAttributes'
enable_script_context:
type: boolean
description: 'Set to true to inject context into custom DB scripts (warning: cannot be disabled once enabled)'
enabledDatabaseCustomization:
type: boolean
description: Set to true to use a legacy user store
import_mode:
type: boolean
description: Enable this if you have a legacy user store and you want to gradually migrate those users to the Auth0 user store
configuration:
type:
- object
- 'null'
description: Stores encrypted string only configurations for connections
additionalProperties:
type:
- string
- 'null'
customScripts:
$ref: '#/components/schemas/ConnectionCustomScripts'
authentication_methods:
$ref: '#/components/schemas/ConnectionAuthenticationMethods'
passkey_options:
$ref: '#/components/schemas/ConnectionPasskeyOptions'
passwordPolicy:
$ref: '#/components/schemas/ConnectionPasswordPolicyEnum'
password_complexity_options:
$ref: '#/components/schemas/ConnectionPasswordComplexityOptions'
password_history:
$ref: '#/components/schemas/ConnectionPasswordHistoryOptions'
password_no_personal_info:
$ref: '#/components/schemas/ConnectionPasswordNoPersonalInfoOptions'
password_dictionary:
$ref: '#/components/schemas/ConnectionPasswordDictionaryOptions'
api_enable_users:
type: boolean
api_enable_groups:
type: boolean
x-release-lifecycle: EA
basic_profile:
type: boolean
ext_admin:
type: boolean
ext_is_suspended:
type: boolean
ext_agreed_terms:
type: boolean
ext_groups:
type: boolean
ext_assigned_plans:
type: boolean
ext_profile:
type: boolean
disable_self_service_change_password:
type: boolean
upstream_params:
$ref: '#/components/schemas/ConnectionUpstreamParams'
set_user_root_attributes:
$ref: '#/components/schemas/ConnectionSetUserRootAttributesEnum'
gateway_authentication:
$ref: '#/components/schemas/ConnectionGatewayAuthentication'
federated_connections_access_tokens:
$ref: '#/components/schemas/ConnectionFederatedConnectionsAccessTokens'
password_options:
$ref: '#/components/schemas/ConnectionPasswordOptions'
x-release-lifecycle: EA
assertion_decryption_settings:
$ref: '#/components/schemas/ConnectionAssertionDecryptionSettings'
id_token_signed_response_algs:
$ref: '#/components/schemas/ConnectionIdTokenSignedResponseAlgs'
token_endpoint_auth_method:
$ref: '#/components/schemas/ConnectionTokenEndpointAuthMethodEnum'
token_endpoint_auth_signing_alg:
$ref: '#/components/schemas/ConnectionTokenEndpointAuthSigningAlgEnum'
token_endpoint_jwtca_aud_format:
$ref: '#/components/schemas/ConnectionTokenEndpointJwtcaAudFormatEnumOIDC'
PasswordMaxLengthExceededPolicyEnum:
type: string
description: Controls whether passwords that exceed the maximum length are truncated or rejected
enum:
- truncate
- error
PostConnectionKeysAlgEnum:
type: string
description: Selected Signing Algorithm
enum:
- RS256
- RS384
- RS512
- PS256
- PS384
- ES256
- ES384
ConnectionStrategyEnum:
type: string
enum:
- ad
- adfs
- amazon
- apple
- dropbox
- bitbucket
- auth0-oidc
- auth0
- baidu
- bitly
- box
- custom
- daccount
- dwolla
- email
- evernote-sandbox
- evernote
- exact
- facebook
- fitbit
- github
- google-apps
- google-oauth2
- instagram
- ip
- line
- linkedin
- oauth1
- oauth2
- office365
- oidc
- okta
- paypal
- paypal-sandbox
- pingfederate
- planningcenter
- salesforce-community
- salesforce-sandbox
- salesforce
- samlp
- sharepoint
- shopify
- shop
- sms
- soundcloud
- thirtysevensignals
- twitter
- untappd
- vkontakte
- waad
- weibo
- windowslive
- wordpress
- yahoo
- yandex
- auth0-adldap
GetDirectoryProvisioningResponseContent:
type: object
additionalProperties: false
required:
- connection_id
- connection_name
- strategy
- mapping
- synchronize_automatically
- created_at
- updated_at
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
synchronize_automatically:
type: boolean
description: Whether periodic automatic synchronization is enabled
synchronize_groups:
$ref: '#/components/schemas/SynchronizeGroupsEnum'
x-release-lifecycle: EA
created_at:
type: string
description: The timestamp at which the directory provisioning configuration was created
format: date-time
updated_at:
type: string
description: The timestamp at which the directory provisioning configuration was last updated
format: date-time
last_synchronization_at:
type: string
description: The timestamp at which the connection was last synchronized
format: date-time
last_synchronization_status:
type: string
description: The status of the last synchronization
last_synchronization_error:
type: string
description: The error message of the last synchronization, if any
CreateDirectoryProvisioningRequestContent:
type:
- object
- 'null'
additionalProperties: false
properties:
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
synchronize_automatically:
type: boolean
description: Whether periodic automatic synchronization is enabled
synchronize_groups:
$ref: '#/components/schemas/SynchronizeGroupsEnum'
x-release-lifecycle: EA
ReplaceSynchronizedGroupsRequestContent:
type: object
additionalProperties: false
required:
- groups
properties:
groups:
type: array
description: Array of Google Workspace Directory group objects to synchronize.
items:
$ref: '#/components/schemas/SynchronizedGroupPayload'
CreateDirectorySynchronizationResponseContent:
type: object
additionalProperties: false
required:
- connection_id
- synchronization_id
- status
properties:
connection_id:
type: string
description: The connection's identifier
synchronization_id:
type: string
description: The synchronization's identifier
status:
type: string
description: The synchronization status
UsernameAllowedTypes:
type: object
additionalProperties: false
properties:
email:
type: boolean
phone_number:
type: boolean
UpdateDirectoryProvisioningResponseContent:
type: object
additionalProperties: false
required:
- connection_id
- connection_name
- strategy
- mapping
- synchronize_automatically
- created_at
- updated_at
properties:
connection_id:
type: string
description: The connection's identifier
connection_name:
type: string
description: The connection's name
strategy:
type: string
description: The connection's strategy
mapping:
type: array
description: The mapping between Auth0 and IDP user attributes
minItems: 1
items:
$ref: '#/components/schemas/DirectoryProvisioningMappingItem'
synchronize_automatically:
type: boolean
description: Whether periodic automatic synchronization is enabled
synchronize_groups:
$ref: '#/components/schemas/SynchronizeGroupsEnum'
x-release-lifecycle: EA
created_at:
type: string
description: The timestamp at which the directory provisioning configuration was created
format: date-time
updated_at:
type: string
description: The timestamp at which the directory provisioning configuration was last updated
format: date-time
last_synchronization_at:
type: string
description: The timestamp at which the connection was last synchronized
format: date-time
last_synchronization_status:
type: string
description: The status of the last synchronization
last_synchronization_error:
type: string
description: The error message of the last synchronization, if any