CognitoIdentityProviderClient#
Index > CognitoIdentityProvider > CognitoIdentityProviderClient
Auto-generated documentation for CognitoIdentityProvider type annotations stubs module types-boto3-cognito-idp.
CognitoIdentityProviderClient#
Type annotations and code completion for boto3.client("cognito-idp")
.
boto3 documentation
# CognitoIdentityProviderClient usage example
from boto3.session import Session
from types_boto3_cognito_idp.client import CognitoIdentityProviderClient
def get_cognito-idp_client() -> CognitoIdentityProviderClient:
return Session().client("cognito-idp")
Exceptions#
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("cognito-idp").exceptions
structure.
# Exceptions.exceptions usage example
client = boto3.client("cognito-idp")
try:
do_something(client)
except (
client.exceptions.AliasExistsException,
client.exceptions.ClientError,
client.exceptions.CodeDeliveryFailureException,
client.exceptions.CodeMismatchException,
client.exceptions.ConcurrentModificationException,
client.exceptions.DuplicateProviderException,
client.exceptions.EnableSoftwareTokenMFAException,
client.exceptions.ExpiredCodeException,
client.exceptions.FeatureUnavailableInTierException,
client.exceptions.ForbiddenException,
client.exceptions.GroupExistsException,
client.exceptions.InternalErrorException,
client.exceptions.InvalidEmailRoleAccessPolicyException,
client.exceptions.InvalidLambdaResponseException,
client.exceptions.InvalidOAuthFlowException,
client.exceptions.InvalidParameterException,
client.exceptions.InvalidPasswordException,
client.exceptions.InvalidSmsRoleAccessPolicyException,
client.exceptions.InvalidSmsRoleTrustRelationshipException,
client.exceptions.InvalidUserPoolConfigurationException,
client.exceptions.LimitExceededException,
client.exceptions.MFAMethodNotFoundException,
client.exceptions.ManagedLoginBrandingExistsException,
client.exceptions.NotAuthorizedException,
client.exceptions.PasswordHistoryPolicyViolationException,
client.exceptions.PasswordResetRequiredException,
client.exceptions.PreconditionNotMetException,
client.exceptions.ResourceNotFoundException,
client.exceptions.ScopeDoesNotExistException,
client.exceptions.SoftwareTokenMFANotFoundException,
client.exceptions.TierChangeNotAllowedException,
client.exceptions.TooManyFailedAttemptsException,
client.exceptions.TooManyRequestsException,
client.exceptions.UnauthorizedException,
client.exceptions.UnexpectedLambdaException,
client.exceptions.UnsupportedIdentityProviderException,
client.exceptions.UnsupportedOperationException,
client.exceptions.UnsupportedTokenTypeException,
client.exceptions.UnsupportedUserStateException,
client.exceptions.UserImportInProgressException,
client.exceptions.UserLambdaValidationException,
client.exceptions.UserNotConfirmedException,
client.exceptions.UserNotFoundException,
client.exceptions.UserPoolAddOnNotEnabledException,
client.exceptions.UserPoolTaggingException,
client.exceptions.UsernameExistsException,
client.exceptions.WebAuthnChallengeNotFoundException,
client.exceptions.WebAuthnClientMismatchException,
client.exceptions.WebAuthnConfigurationMissingException,
client.exceptions.WebAuthnCredentialNotSupportedException,
client.exceptions.WebAuthnNotEnabledException,
client.exceptions.WebAuthnOriginNotAllowedException,
client.exceptions.WebAuthnRelyingPartyMismatchException,
) as e:
print(e)
# Exceptions.exceptions type checking example
from types_boto3_cognito_idp.client import Exceptions
def handle_error(exc: Exceptions.AliasExistsException) -> None:
...
Methods#
can_paginate#
Type annotations and code completion for boto3.client("cognito-idp").can_paginate
method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...
generate_presigned_url#
Type annotations and code completion for boto3.client("cognito-idp").generate_presigned_url
method.
boto3 documentation
# generate_presigned_url method definition
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...
add_custom_attributes#
Adds additional user attributes to the user pool schema.
Type annotations and code completion for boto3.client("cognito-idp").add_custom_attributes
method.
boto3 documentation
# add_custom_attributes method definition
def add_custom_attributes(
self,
*,
UserPoolId: str,
CustomAttributes: Sequence[SchemaAttributeTypeTypeDef], # (1)
) -> dict[str, Any]:
...
# add_custom_attributes method usage example with argument unpacking
kwargs: AddCustomAttributesRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"CustomAttributes": ...,
}
parent.add_custom_attributes(**kwargs)
admin_add_user_to_group#
Adds a user to a group.
Type annotations and code completion for boto3.client("cognito-idp").admin_add_user_to_group
method.
boto3 documentation
# admin_add_user_to_group method definition
def admin_add_user_to_group(
self,
*,
UserPoolId: str,
Username: str,
GroupName: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# admin_add_user_to_group method usage example with argument unpacking
kwargs: AdminAddUserToGroupRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"GroupName": ...,
}
parent.admin_add_user_to_group(**kwargs)
admin_confirm_sign_up#
Confirms user sign-up as an administrator.
Type annotations and code completion for boto3.client("cognito-idp").admin_confirm_sign_up
method.
boto3 documentation
# admin_confirm_sign_up method definition
def admin_confirm_sign_up(
self,
*,
UserPoolId: str,
Username: str,
ClientMetadata: Mapping[str, str] = ...,
) -> dict[str, Any]:
...
# admin_confirm_sign_up method usage example with argument unpacking
kwargs: AdminConfirmSignUpRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_confirm_sign_up(**kwargs)
admin_create_user#
Creates a new user in the specified user pool.
Type annotations and code completion for boto3.client("cognito-idp").admin_create_user
method.
boto3 documentation
# admin_create_user method definition
def admin_create_user(
self,
*,
UserPoolId: str,
Username: str,
UserAttributes: Sequence[AttributeTypeTypeDef] = ..., # (1)
ValidationData: Sequence[AttributeTypeTypeDef] = ..., # (1)
TemporaryPassword: str = ...,
ForceAliasCreation: bool = ...,
MessageAction: MessageActionTypeType = ..., # (3)
DesiredDeliveryMediums: Sequence[DeliveryMediumTypeType] = ..., # (4)
ClientMetadata: Mapping[str, str] = ...,
) -> AdminCreateUserResponseTypeDef: # (5)
...
- See AttributeTypeTypeDef
- See AttributeTypeTypeDef
- See MessageActionTypeType
- See DeliveryMediumTypeType
- See AdminCreateUserResponseTypeDef
# admin_create_user method usage example with argument unpacking
kwargs: AdminCreateUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_create_user(**kwargs)
admin_delete_user#
Deletes a user profile in your user pool.
Type annotations and code completion for boto3.client("cognito-idp").admin_delete_user
method.
boto3 documentation
# admin_delete_user method definition
def admin_delete_user(
self,
*,
UserPoolId: str,
Username: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# admin_delete_user method usage example with argument unpacking
kwargs: AdminDeleteUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_delete_user(**kwargs)
admin_delete_user_attributes#
Deletes attribute values from a user.
Type annotations and code completion for boto3.client("cognito-idp").admin_delete_user_attributes
method.
boto3 documentation
# admin_delete_user_attributes method definition
def admin_delete_user_attributes(
self,
*,
UserPoolId: str,
Username: str,
UserAttributeNames: Sequence[str],
) -> dict[str, Any]:
...
# admin_delete_user_attributes method usage example with argument unpacking
kwargs: AdminDeleteUserAttributesRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"UserAttributeNames": ...,
}
parent.admin_delete_user_attributes(**kwargs)
admin_disable_provider_for_user#
Prevents the user from signing in with the specified external (SAML or social) identity provider (IdP).
Type annotations and code completion for boto3.client("cognito-idp").admin_disable_provider_for_user
method.
boto3 documentation
# admin_disable_provider_for_user method definition
def admin_disable_provider_for_user(
self,
*,
UserPoolId: str,
User: ProviderUserIdentifierTypeTypeDef, # (1)
) -> dict[str, Any]:
...
# admin_disable_provider_for_user method usage example with argument unpacking
kwargs: AdminDisableProviderForUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"User": ...,
}
parent.admin_disable_provider_for_user(**kwargs)
admin_disable_user#
Deactivates a user profile and revokes all access tokens for the user.
Type annotations and code completion for boto3.client("cognito-idp").admin_disable_user
method.
boto3 documentation
# admin_disable_user method definition
def admin_disable_user(
self,
*,
UserPoolId: str,
Username: str,
) -> dict[str, Any]:
...
# admin_disable_user method usage example with argument unpacking
kwargs: AdminDisableUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_disable_user(**kwargs)
admin_enable_user#
Activate sign-in for a user profile that previously had sign-in access disabled.
Type annotations and code completion for boto3.client("cognito-idp").admin_enable_user
method.
boto3 documentation
# admin_enable_user method definition
def admin_enable_user(
self,
*,
UserPoolId: str,
Username: str,
) -> dict[str, Any]:
...
# admin_enable_user method usage example with argument unpacking
kwargs: AdminEnableUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_enable_user(**kwargs)
admin_forget_device#
Forgets, or deletes, a remembered device from a user's profile.
Type annotations and code completion for boto3.client("cognito-idp").admin_forget_device
method.
boto3 documentation
# admin_forget_device method definition
def admin_forget_device(
self,
*,
UserPoolId: str,
Username: str,
DeviceKey: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# admin_forget_device method usage example with argument unpacking
kwargs: AdminForgetDeviceRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"DeviceKey": ...,
}
parent.admin_forget_device(**kwargs)
admin_get_device#
Given the device key, returns details for a user' device.
Type annotations and code completion for boto3.client("cognito-idp").admin_get_device
method.
boto3 documentation
# admin_get_device method definition
def admin_get_device(
self,
*,
DeviceKey: str,
UserPoolId: str,
Username: str,
) -> AdminGetDeviceResponseTypeDef: # (1)
...
# admin_get_device method usage example with argument unpacking
kwargs: AdminGetDeviceRequestRequestTypeDef = { # (1)
"DeviceKey": ...,
"UserPoolId": ...,
"Username": ...,
}
parent.admin_get_device(**kwargs)
admin_get_user#
Given the username, returns details about a user profile in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").admin_get_user
method.
boto3 documentation
# admin_get_user method definition
def admin_get_user(
self,
*,
UserPoolId: str,
Username: str,
) -> AdminGetUserResponseTypeDef: # (1)
...
# admin_get_user method usage example with argument unpacking
kwargs: AdminGetUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_get_user(**kwargs)
admin_initiate_auth#
Starts sign-in for applications with a server-side component, for example a traditional web application.
Type annotations and code completion for boto3.client("cognito-idp").admin_initiate_auth
method.
boto3 documentation
# admin_initiate_auth method definition
def admin_initiate_auth(
self,
*,
UserPoolId: str,
ClientId: str,
AuthFlow: AuthFlowTypeType, # (1)
AuthParameters: Mapping[str, str] = ...,
ClientMetadata: Mapping[str, str] = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
ContextData: ContextDataTypeTypeDef = ..., # (3)
Session: str = ...,
) -> AdminInitiateAuthResponseTypeDef: # (4)
...
- See AuthFlowTypeType
- See AnalyticsMetadataTypeTypeDef
- See ContextDataTypeTypeDef
- See AdminInitiateAuthResponseTypeDef
# admin_initiate_auth method usage example with argument unpacking
kwargs: AdminInitiateAuthRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
"AuthFlow": ...,
}
parent.admin_initiate_auth(**kwargs)
admin_link_provider_for_user#
Links an existing user account in a user pool (DestinationUser
) to
an identity from an external IdP (SourceUser
) based on a specified
attribute name and value from the external IdP.
Type annotations and code completion for boto3.client("cognito-idp").admin_link_provider_for_user
method.
boto3 documentation
# admin_link_provider_for_user method definition
def admin_link_provider_for_user(
self,
*,
UserPoolId: str,
DestinationUser: ProviderUserIdentifierTypeTypeDef, # (1)
SourceUser: ProviderUserIdentifierTypeTypeDef, # (1)
) -> dict[str, Any]:
...
# admin_link_provider_for_user method usage example with argument unpacking
kwargs: AdminLinkProviderForUserRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"DestinationUser": ...,
"SourceUser": ...,
}
parent.admin_link_provider_for_user(**kwargs)
admin_list_devices#
Lists a user's registered devices.
Type annotations and code completion for boto3.client("cognito-idp").admin_list_devices
method.
boto3 documentation
# admin_list_devices method definition
def admin_list_devices(
self,
*,
UserPoolId: str,
Username: str,
Limit: int = ...,
PaginationToken: str = ...,
) -> AdminListDevicesResponseTypeDef: # (1)
...
# admin_list_devices method usage example with argument unpacking
kwargs: AdminListDevicesRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_list_devices(**kwargs)
admin_list_groups_for_user#
Lists the groups that a user belongs to.
Type annotations and code completion for boto3.client("cognito-idp").admin_list_groups_for_user
method.
boto3 documentation
# admin_list_groups_for_user method definition
def admin_list_groups_for_user(
self,
*,
Username: str,
UserPoolId: str,
Limit: int = ...,
NextToken: str = ...,
) -> AdminListGroupsForUserResponseTypeDef: # (1)
...
# admin_list_groups_for_user method usage example with argument unpacking
kwargs: AdminListGroupsForUserRequestRequestTypeDef = { # (1)
"Username": ...,
"UserPoolId": ...,
}
parent.admin_list_groups_for_user(**kwargs)
admin_list_user_auth_events#
Requests a history of user activity and any risks detected as part of Amazon Cognito threat protection.
Type annotations and code completion for boto3.client("cognito-idp").admin_list_user_auth_events
method.
boto3 documentation
# admin_list_user_auth_events method definition
def admin_list_user_auth_events(
self,
*,
UserPoolId: str,
Username: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> AdminListUserAuthEventsResponseTypeDef: # (1)
...
# admin_list_user_auth_events method usage example with argument unpacking
kwargs: AdminListUserAuthEventsRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_list_user_auth_events(**kwargs)
admin_remove_user_from_group#
Given a username and a group name.
Type annotations and code completion for boto3.client("cognito-idp").admin_remove_user_from_group
method.
boto3 documentation
# admin_remove_user_from_group method definition
def admin_remove_user_from_group(
self,
*,
UserPoolId: str,
Username: str,
GroupName: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# admin_remove_user_from_group method usage example with argument unpacking
kwargs: AdminRemoveUserFromGroupRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"GroupName": ...,
}
parent.admin_remove_user_from_group(**kwargs)
admin_reset_user_password#
Resets the specified user's password in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").admin_reset_user_password
method.
boto3 documentation
# admin_reset_user_password method definition
def admin_reset_user_password(
self,
*,
UserPoolId: str,
Username: str,
ClientMetadata: Mapping[str, str] = ...,
) -> dict[str, Any]:
...
# admin_reset_user_password method usage example with argument unpacking
kwargs: AdminResetUserPasswordRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_reset_user_password(**kwargs)
admin_respond_to_auth_challenge#
Some API operations in a user pool generate a challenge, like a prompt for an MFA code, for device authentication that bypasses MFA, or for a custom authentication challenge.
Type annotations and code completion for boto3.client("cognito-idp").admin_respond_to_auth_challenge
method.
boto3 documentation
# admin_respond_to_auth_challenge method definition
def admin_respond_to_auth_challenge(
self,
*,
UserPoolId: str,
ClientId: str,
ChallengeName: ChallengeNameTypeType, # (1)
ChallengeResponses: Mapping[str, str] = ...,
Session: str = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
ContextData: ContextDataTypeTypeDef = ..., # (3)
ClientMetadata: Mapping[str, str] = ...,
) -> AdminRespondToAuthChallengeResponseTypeDef: # (4)
...
- See ChallengeNameTypeType
- See AnalyticsMetadataTypeTypeDef
- See ContextDataTypeTypeDef
- See AdminRespondToAuthChallengeResponseTypeDef
# admin_respond_to_auth_challenge method usage example with argument unpacking
kwargs: AdminRespondToAuthChallengeRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
"ChallengeName": ...,
}
parent.admin_respond_to_auth_challenge(**kwargs)
admin_set_user_mfa_preference#
Sets the user's multi-factor authentication (MFA) preference, including which MFA options are activated, and if any are preferred.
Type annotations and code completion for boto3.client("cognito-idp").admin_set_user_mfa_preference
method.
boto3 documentation
# admin_set_user_mfa_preference method definition
def admin_set_user_mfa_preference(
self,
*,
Username: str,
UserPoolId: str,
SMSMfaSettings: SMSMfaSettingsTypeTypeDef = ..., # (1)
SoftwareTokenMfaSettings: SoftwareTokenMfaSettingsTypeTypeDef = ..., # (2)
EmailMfaSettings: EmailMfaSettingsTypeTypeDef = ..., # (3)
) -> dict[str, Any]:
...
- See SMSMfaSettingsTypeTypeDef
- See SoftwareTokenMfaSettingsTypeTypeDef
- See EmailMfaSettingsTypeTypeDef
# admin_set_user_mfa_preference method usage example with argument unpacking
kwargs: AdminSetUserMFAPreferenceRequestRequestTypeDef = { # (1)
"Username": ...,
"UserPoolId": ...,
}
parent.admin_set_user_mfa_preference(**kwargs)
admin_set_user_password#
Sets the specified user's password in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").admin_set_user_password
method.
boto3 documentation
# admin_set_user_password method definition
def admin_set_user_password(
self,
*,
UserPoolId: str,
Username: str,
Password: str,
Permanent: bool = ...,
) -> dict[str, Any]:
...
# admin_set_user_password method usage example with argument unpacking
kwargs: AdminSetUserPasswordRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"Password": ...,
}
parent.admin_set_user_password(**kwargs)
admin_set_user_settings#
This action is no longer supported. You can use it to configure only SMS MFA.
Type annotations and code completion for boto3.client("cognito-idp").admin_set_user_settings
method.
boto3 documentation
# admin_set_user_settings method definition
def admin_set_user_settings(
self,
*,
UserPoolId: str,
Username: str,
MFAOptions: Sequence[MFAOptionTypeTypeDef], # (1)
) -> dict[str, Any]:
...
# admin_set_user_settings method usage example with argument unpacking
kwargs: AdminSetUserSettingsRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"MFAOptions": ...,
}
parent.admin_set_user_settings(**kwargs)
admin_update_auth_event_feedback#
Provides feedback for an authentication event indicating if it was from a valid user.
Type annotations and code completion for boto3.client("cognito-idp").admin_update_auth_event_feedback
method.
boto3 documentation
# admin_update_auth_event_feedback method definition
def admin_update_auth_event_feedback(
self,
*,
UserPoolId: str,
Username: str,
EventId: str,
FeedbackValue: FeedbackValueTypeType, # (1)
) -> dict[str, Any]:
...
# admin_update_auth_event_feedback method usage example with argument unpacking
kwargs: AdminUpdateAuthEventFeedbackRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"EventId": ...,
"FeedbackValue": ...,
}
parent.admin_update_auth_event_feedback(**kwargs)
admin_update_device_status#
Updates the status of a user's device so that it is marked as remembered or not remembered for the purpose of device authentication.
Type annotations and code completion for boto3.client("cognito-idp").admin_update_device_status
method.
boto3 documentation
# admin_update_device_status method definition
def admin_update_device_status(
self,
*,
UserPoolId: str,
Username: str,
DeviceKey: str,
DeviceRememberedStatus: DeviceRememberedStatusTypeType = ..., # (1)
) -> dict[str, Any]:
...
# admin_update_device_status method usage example with argument unpacking
kwargs: AdminUpdateDeviceStatusRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"DeviceKey": ...,
}
parent.admin_update_device_status(**kwargs)
admin_update_user_attributes#
This action might generate an SMS text message.
Type annotations and code completion for boto3.client("cognito-idp").admin_update_user_attributes
method.
boto3 documentation
# admin_update_user_attributes method definition
def admin_update_user_attributes(
self,
*,
UserPoolId: str,
Username: str,
UserAttributes: Sequence[AttributeTypeTypeDef], # (1)
ClientMetadata: Mapping[str, str] = ...,
) -> dict[str, Any]:
...
# admin_update_user_attributes method usage example with argument unpacking
kwargs: AdminUpdateUserAttributesRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"UserAttributes": ...,
}
parent.admin_update_user_attributes(**kwargs)
admin_user_global_sign_out#
Invalidates the identity, access, and refresh tokens that Amazon Cognito issued to a user.
Type annotations and code completion for boto3.client("cognito-idp").admin_user_global_sign_out
method.
boto3 documentation
# admin_user_global_sign_out method definition
def admin_user_global_sign_out(
self,
*,
UserPoolId: str,
Username: str,
) -> dict[str, Any]:
...
# admin_user_global_sign_out method usage example with argument unpacking
kwargs: AdminUserGlobalSignOutRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
}
parent.admin_user_global_sign_out(**kwargs)
associate_software_token#
Begins setup of time-based one-time password (TOTP) multi-factor authentication (MFA) for a user, with a unique private key that Amazon Cognito generates and returns in the API response.
Type annotations and code completion for boto3.client("cognito-idp").associate_software_token
method.
boto3 documentation
# associate_software_token method definition
def associate_software_token(
self,
*,
AccessToken: str = ...,
Session: str = ...,
) -> AssociateSoftwareTokenResponseTypeDef: # (1)
...
# associate_software_token method usage example with argument unpacking
kwargs: AssociateSoftwareTokenRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.associate_software_token(**kwargs)
change_password#
Changes the password for a specified user in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").change_password
method.
boto3 documentation
# change_password method definition
def change_password(
self,
*,
ProposedPassword: str,
AccessToken: str,
PreviousPassword: str = ...,
) -> dict[str, Any]:
...
# change_password method usage example with argument unpacking
kwargs: ChangePasswordRequestRequestTypeDef = { # (1)
"ProposedPassword": ...,
"AccessToken": ...,
}
parent.change_password(**kwargs)
complete_web_authn_registration#
Completes registration of a passkey authenticator for the current user.
Type annotations and code completion for boto3.client("cognito-idp").complete_web_authn_registration
method.
boto3 documentation
# complete_web_authn_registration method definition
def complete_web_authn_registration(
self,
*,
AccessToken: str,
Credential: Mapping[str, Any],
) -> dict[str, Any]:
...
# complete_web_authn_registration method usage example with argument unpacking
kwargs: CompleteWebAuthnRegistrationRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"Credential": ...,
}
parent.complete_web_authn_registration(**kwargs)
confirm_device#
Confirms a device that a user wants to remember.
Type annotations and code completion for boto3.client("cognito-idp").confirm_device
method.
boto3 documentation
# confirm_device method definition
def confirm_device(
self,
*,
AccessToken: str,
DeviceKey: str,
DeviceSecretVerifierConfig: DeviceSecretVerifierConfigTypeTypeDef = ..., # (1)
DeviceName: str = ...,
) -> ConfirmDeviceResponseTypeDef: # (2)
...
# confirm_device method usage example with argument unpacking
kwargs: ConfirmDeviceRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"DeviceKey": ...,
}
parent.confirm_device(**kwargs)
confirm_forgot_password#
This public API operation accepts a confirmation code that Amazon Cognito sent to a user and accepts a new password for that user.
Type annotations and code completion for boto3.client("cognito-idp").confirm_forgot_password
method.
boto3 documentation
# confirm_forgot_password method definition
def confirm_forgot_password(
self,
*,
ClientId: str,
Username: str,
ConfirmationCode: str,
Password: str,
SecretHash: str = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (1)
UserContextData: UserContextDataTypeTypeDef = ..., # (2)
ClientMetadata: Mapping[str, str] = ...,
) -> dict[str, Any]:
...
# confirm_forgot_password method usage example with argument unpacking
kwargs: ConfirmForgotPasswordRequestRequestTypeDef = { # (1)
"ClientId": ...,
"Username": ...,
"ConfirmationCode": ...,
"Password": ...,
}
parent.confirm_forgot_password(**kwargs)
confirm_sign_up#
This public API operation submits a code that Amazon Cognito sent to your user when they signed up in your user pool via the SignUp API operation.
Type annotations and code completion for boto3.client("cognito-idp").confirm_sign_up
method.
boto3 documentation
# confirm_sign_up method definition
def confirm_sign_up(
self,
*,
ClientId: str,
Username: str,
ConfirmationCode: str,
SecretHash: str = ...,
ForceAliasCreation: bool = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (1)
UserContextData: UserContextDataTypeTypeDef = ..., # (2)
ClientMetadata: Mapping[str, str] = ...,
Session: str = ...,
) -> ConfirmSignUpResponseTypeDef: # (3)
...
# confirm_sign_up method usage example with argument unpacking
kwargs: ConfirmSignUpRequestRequestTypeDef = { # (1)
"ClientId": ...,
"Username": ...,
"ConfirmationCode": ...,
}
parent.confirm_sign_up(**kwargs)
create_group#
Creates a new group in the specified user pool.
Type annotations and code completion for boto3.client("cognito-idp").create_group
method.
boto3 documentation
# create_group method definition
def create_group(
self,
*,
GroupName: str,
UserPoolId: str,
Description: str = ...,
RoleArn: str = ...,
Precedence: int = ...,
) -> CreateGroupResponseTypeDef: # (1)
...
# create_group method usage example with argument unpacking
kwargs: CreateGroupRequestRequestTypeDef = { # (1)
"GroupName": ...,
"UserPoolId": ...,
}
parent.create_group(**kwargs)
create_identity_provider#
Adds a configuration and trust relationship between a third-party identity provider (IdP) and a user pool.
Type annotations and code completion for boto3.client("cognito-idp").create_identity_provider
method.
boto3 documentation
# create_identity_provider method definition
def create_identity_provider(
self,
*,
UserPoolId: str,
ProviderName: str,
ProviderType: IdentityProviderTypeTypeType, # (1)
ProviderDetails: Mapping[str, str],
AttributeMapping: Mapping[str, str] = ...,
IdpIdentifiers: Sequence[str] = ...,
) -> CreateIdentityProviderResponseTypeDef: # (2)
...
# create_identity_provider method usage example with argument unpacking
kwargs: CreateIdentityProviderRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ProviderName": ...,
"ProviderType": ...,
"ProviderDetails": ...,
}
parent.create_identity_provider(**kwargs)
create_managed_login_branding#
Creates a new set of branding settings for a user pool style and associates it with an app client.
Type annotations and code completion for boto3.client("cognito-idp").create_managed_login_branding
method.
boto3 documentation
# create_managed_login_branding method definition
def create_managed_login_branding(
self,
*,
UserPoolId: str,
ClientId: str,
UseCognitoProvidedValues: bool = ...,
Settings: Mapping[str, Any] = ...,
Assets: Sequence[AssetTypeUnionTypeDef] = ..., # (1)
) -> CreateManagedLoginBrandingResponseTypeDef: # (2)
...
# create_managed_login_branding method usage example with argument unpacking
kwargs: CreateManagedLoginBrandingRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
}
parent.create_managed_login_branding(**kwargs)
create_resource_server#
Creates a new OAuth2.0 resource server and defines custom scopes within it.
Type annotations and code completion for boto3.client("cognito-idp").create_resource_server
method.
boto3 documentation
# create_resource_server method definition
def create_resource_server(
self,
*,
UserPoolId: str,
Identifier: str,
Name: str,
Scopes: Sequence[ResourceServerScopeTypeTypeDef] = ..., # (1)
) -> CreateResourceServerResponseTypeDef: # (2)
...
# create_resource_server method usage example with argument unpacking
kwargs: CreateResourceServerRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Identifier": ...,
"Name": ...,
}
parent.create_resource_server(**kwargs)
create_user_import_job#
Creates a user import job.
Type annotations and code completion for boto3.client("cognito-idp").create_user_import_job
method.
boto3 documentation
# create_user_import_job method definition
def create_user_import_job(
self,
*,
JobName: str,
UserPoolId: str,
CloudWatchLogsRoleArn: str,
) -> CreateUserImportJobResponseTypeDef: # (1)
...
# create_user_import_job method usage example with argument unpacking
kwargs: CreateUserImportJobRequestRequestTypeDef = { # (1)
"JobName": ...,
"UserPoolId": ...,
"CloudWatchLogsRoleArn": ...,
}
parent.create_user_import_job(**kwargs)
create_user_pool#
This action might generate an SMS text message.
Type annotations and code completion for boto3.client("cognito-idp").create_user_pool
method.
boto3 documentation
# create_user_pool method definition
def create_user_pool(
self,
*,
PoolName: str,
Policies: UserPoolPolicyTypeTypeDef = ..., # (1)
DeletionProtection: DeletionProtectionTypeType = ..., # (2)
LambdaConfig: LambdaConfigTypeTypeDef = ..., # (3)
AutoVerifiedAttributes: Sequence[VerifiedAttributeTypeType] = ..., # (4)
AliasAttributes: Sequence[AliasAttributeTypeType] = ..., # (5)
UsernameAttributes: Sequence[UsernameAttributeTypeType] = ..., # (6)
SmsVerificationMessage: str = ...,
EmailVerificationMessage: str = ...,
EmailVerificationSubject: str = ...,
VerificationMessageTemplate: VerificationMessageTemplateTypeTypeDef = ..., # (7)
SmsAuthenticationMessage: str = ...,
MfaConfiguration: UserPoolMfaTypeType = ..., # (8)
UserAttributeUpdateSettings: UserAttributeUpdateSettingsTypeTypeDef = ..., # (9)
DeviceConfiguration: DeviceConfigurationTypeTypeDef = ..., # (10)
EmailConfiguration: EmailConfigurationTypeTypeDef = ..., # (11)
SmsConfiguration: SmsConfigurationTypeTypeDef = ..., # (12)
UserPoolTags: Mapping[str, str] = ...,
AdminCreateUserConfig: AdminCreateUserConfigTypeTypeDef = ..., # (13)
Schema: Sequence[SchemaAttributeTypeTypeDef] = ..., # (14)
UserPoolAddOns: UserPoolAddOnsTypeTypeDef = ..., # (15)
UsernameConfiguration: UsernameConfigurationTypeTypeDef = ..., # (16)
AccountRecoverySetting: AccountRecoverySettingTypeTypeDef = ..., # (17)
UserPoolTier: UserPoolTierTypeType = ..., # (18)
) -> CreateUserPoolResponseTypeDef: # (19)
...
- See UserPoolPolicyTypeTypeDef
- See DeletionProtectionTypeType
- See LambdaConfigTypeTypeDef
- See VerifiedAttributeTypeType
- See AliasAttributeTypeType
- See UsernameAttributeTypeType
- See VerificationMessageTemplateTypeTypeDef
- See UserPoolMfaTypeType
- See UserAttributeUpdateSettingsTypeTypeDef
- See DeviceConfigurationTypeTypeDef
- See EmailConfigurationTypeTypeDef
- See SmsConfigurationTypeTypeDef
- See AdminCreateUserConfigTypeTypeDef
- See SchemaAttributeTypeTypeDef
- See UserPoolAddOnsTypeTypeDef
- See UsernameConfigurationTypeTypeDef
- See AccountRecoverySettingTypeTypeDef
- See UserPoolTierTypeType
- See CreateUserPoolResponseTypeDef
# create_user_pool method usage example with argument unpacking
kwargs: CreateUserPoolRequestRequestTypeDef = { # (1)
"PoolName": ...,
}
parent.create_user_pool(**kwargs)
create_user_pool_client#
Creates an app client in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").create_user_pool_client
method.
boto3 documentation
# create_user_pool_client method definition
def create_user_pool_client(
self,
*,
UserPoolId: str,
ClientName: str,
GenerateSecret: bool = ...,
RefreshTokenValidity: int = ...,
AccessTokenValidity: int = ...,
IdTokenValidity: int = ...,
TokenValidityUnits: TokenValidityUnitsTypeTypeDef = ..., # (1)
ReadAttributes: Sequence[str] = ...,
WriteAttributes: Sequence[str] = ...,
ExplicitAuthFlows: Sequence[ExplicitAuthFlowsTypeType] = ..., # (2)
SupportedIdentityProviders: Sequence[str] = ...,
CallbackURLs: Sequence[str] = ...,
LogoutURLs: Sequence[str] = ...,
DefaultRedirectURI: str = ...,
AllowedOAuthFlows: Sequence[OAuthFlowTypeType] = ..., # (3)
AllowedOAuthScopes: Sequence[str] = ...,
AllowedOAuthFlowsUserPoolClient: bool = ...,
AnalyticsConfiguration: AnalyticsConfigurationTypeTypeDef = ..., # (4)
PreventUserExistenceErrors: PreventUserExistenceErrorTypesType = ..., # (5)
EnableTokenRevocation: bool = ...,
EnablePropagateAdditionalUserContextData: bool = ...,
AuthSessionValidity: int = ...,
) -> CreateUserPoolClientResponseTypeDef: # (6)
...
- See TokenValidityUnitsTypeTypeDef
- See ExplicitAuthFlowsTypeType
- See OAuthFlowTypeType
- See AnalyticsConfigurationTypeTypeDef
- See PreventUserExistenceErrorTypesType
- See CreateUserPoolClientResponseTypeDef
# create_user_pool_client method usage example with argument unpacking
kwargs: CreateUserPoolClientRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientName": ...,
}
parent.create_user_pool_client(**kwargs)
create_user_pool_domain#
A user pool domain hosts managed login, an authorization server and web server for authentication in your application.
Type annotations and code completion for boto3.client("cognito-idp").create_user_pool_domain
method.
boto3 documentation
# create_user_pool_domain method definition
def create_user_pool_domain(
self,
*,
Domain: str,
UserPoolId: str,
ManagedLoginVersion: int = ...,
CustomDomainConfig: CustomDomainConfigTypeTypeDef = ..., # (1)
) -> CreateUserPoolDomainResponseTypeDef: # (2)
...
# create_user_pool_domain method usage example with argument unpacking
kwargs: CreateUserPoolDomainRequestRequestTypeDef = { # (1)
"Domain": ...,
"UserPoolId": ...,
}
parent.create_user_pool_domain(**kwargs)
delete_group#
Deletes a group from the specified user pool.
Type annotations and code completion for boto3.client("cognito-idp").delete_group
method.
boto3 documentation
# delete_group method definition
def delete_group(
self,
*,
GroupName: str,
UserPoolId: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_group method usage example with argument unpacking
kwargs: DeleteGroupRequestRequestTypeDef = { # (1)
"GroupName": ...,
"UserPoolId": ...,
}
parent.delete_group(**kwargs)
delete_identity_provider#
Deletes a user pool identity provider (IdP).
Type annotations and code completion for boto3.client("cognito-idp").delete_identity_provider
method.
boto3 documentation
# delete_identity_provider method definition
def delete_identity_provider(
self,
*,
UserPoolId: str,
ProviderName: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_identity_provider method usage example with argument unpacking
kwargs: DeleteIdentityProviderRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ProviderName": ...,
}
parent.delete_identity_provider(**kwargs)
delete_managed_login_branding#
Deletes a managed login branding style.
Type annotations and code completion for boto3.client("cognito-idp").delete_managed_login_branding
method.
boto3 documentation
# delete_managed_login_branding method definition
def delete_managed_login_branding(
self,
*,
ManagedLoginBrandingId: str,
UserPoolId: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_managed_login_branding method usage example with argument unpacking
kwargs: DeleteManagedLoginBrandingRequestRequestTypeDef = { # (1)
"ManagedLoginBrandingId": ...,
"UserPoolId": ...,
}
parent.delete_managed_login_branding(**kwargs)
delete_resource_server#
Deletes a resource server.
Type annotations and code completion for boto3.client("cognito-idp").delete_resource_server
method.
boto3 documentation
# delete_resource_server method definition
def delete_resource_server(
self,
*,
UserPoolId: str,
Identifier: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_resource_server method usage example with argument unpacking
kwargs: DeleteResourceServerRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Identifier": ...,
}
parent.delete_resource_server(**kwargs)
delete_user#
Self-deletes a user profile.
Type annotations and code completion for boto3.client("cognito-idp").delete_user
method.
boto3 documentation
# delete_user method definition
def delete_user(
self,
*,
AccessToken: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_user method usage example with argument unpacking
kwargs: DeleteUserRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.delete_user(**kwargs)
delete_user_attributes#
Self-deletes attributes for a user.
Type annotations and code completion for boto3.client("cognito-idp").delete_user_attributes
method.
boto3 documentation
# delete_user_attributes method definition
def delete_user_attributes(
self,
*,
UserAttributeNames: Sequence[str],
AccessToken: str,
) -> dict[str, Any]:
...
# delete_user_attributes method usage example with argument unpacking
kwargs: DeleteUserAttributesRequestRequestTypeDef = { # (1)
"UserAttributeNames": ...,
"AccessToken": ...,
}
parent.delete_user_attributes(**kwargs)
delete_user_pool#
Deletes a user pool.
Type annotations and code completion for boto3.client("cognito-idp").delete_user_pool
method.
boto3 documentation
# delete_user_pool method definition
def delete_user_pool(
self,
*,
UserPoolId: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_user_pool method usage example with argument unpacking
kwargs: DeleteUserPoolRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.delete_user_pool(**kwargs)
delete_user_pool_client#
Deletes a user pool app client.
Type annotations and code completion for boto3.client("cognito-idp").delete_user_pool_client
method.
boto3 documentation
# delete_user_pool_client method definition
def delete_user_pool_client(
self,
*,
UserPoolId: str,
ClientId: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_user_pool_client method usage example with argument unpacking
kwargs: DeleteUserPoolClientRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
}
parent.delete_user_pool_client(**kwargs)
delete_user_pool_domain#
Given a user pool ID and domain identifier, deletes a user pool domain.
Type annotations and code completion for boto3.client("cognito-idp").delete_user_pool_domain
method.
boto3 documentation
# delete_user_pool_domain method definition
def delete_user_pool_domain(
self,
*,
Domain: str,
UserPoolId: str,
) -> dict[str, Any]:
...
# delete_user_pool_domain method usage example with argument unpacking
kwargs: DeleteUserPoolDomainRequestRequestTypeDef = { # (1)
"Domain": ...,
"UserPoolId": ...,
}
parent.delete_user_pool_domain(**kwargs)
delete_web_authn_credential#
Deletes a registered passkey, or webauthN, authenticator for the currently signed-in user.
Type annotations and code completion for boto3.client("cognito-idp").delete_web_authn_credential
method.
boto3 documentation
# delete_web_authn_credential method definition
def delete_web_authn_credential(
self,
*,
AccessToken: str,
CredentialId: str,
) -> dict[str, Any]:
...
# delete_web_authn_credential method usage example with argument unpacking
kwargs: DeleteWebAuthnCredentialRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"CredentialId": ...,
}
parent.delete_web_authn_credential(**kwargs)
describe_identity_provider#
Given a user pool ID and identity provider (IdP) name, returns details about the IdP.
Type annotations and code completion for boto3.client("cognito-idp").describe_identity_provider
method.
boto3 documentation
# describe_identity_provider method definition
def describe_identity_provider(
self,
*,
UserPoolId: str,
ProviderName: str,
) -> DescribeIdentityProviderResponseTypeDef: # (1)
...
# describe_identity_provider method usage example with argument unpacking
kwargs: DescribeIdentityProviderRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ProviderName": ...,
}
parent.describe_identity_provider(**kwargs)
describe_managed_login_branding#
Given the ID of a managed login branding style, returns detailed information about the style.
Type annotations and code completion for boto3.client("cognito-idp").describe_managed_login_branding
method.
boto3 documentation
# describe_managed_login_branding method definition
def describe_managed_login_branding(
self,
*,
UserPoolId: str,
ManagedLoginBrandingId: str,
ReturnMergedResources: bool = ...,
) -> DescribeManagedLoginBrandingResponseTypeDef: # (1)
...
# describe_managed_login_branding method usage example with argument unpacking
kwargs: DescribeManagedLoginBrandingRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ManagedLoginBrandingId": ...,
}
parent.describe_managed_login_branding(**kwargs)
describe_managed_login_branding_by_client#
Given the ID of a user pool app client, returns detailed information about the style assigned to the app client.
Type annotations and code completion for boto3.client("cognito-idp").describe_managed_login_branding_by_client
method.
boto3 documentation
# describe_managed_login_branding_by_client method definition
def describe_managed_login_branding_by_client(
self,
*,
UserPoolId: str,
ClientId: str,
ReturnMergedResources: bool = ...,
) -> DescribeManagedLoginBrandingByClientResponseTypeDef: # (1)
...
# describe_managed_login_branding_by_client method usage example with argument unpacking
kwargs: DescribeManagedLoginBrandingByClientRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
}
parent.describe_managed_login_branding_by_client(**kwargs)
describe_resource_server#
Describes a resource server.
Type annotations and code completion for boto3.client("cognito-idp").describe_resource_server
method.
boto3 documentation
# describe_resource_server method definition
def describe_resource_server(
self,
*,
UserPoolId: str,
Identifier: str,
) -> DescribeResourceServerResponseTypeDef: # (1)
...
# describe_resource_server method usage example with argument unpacking
kwargs: DescribeResourceServerRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Identifier": ...,
}
parent.describe_resource_server(**kwargs)
describe_risk_configuration#
Given an app client or user pool ID where threat protection is configured, describes the risk configuration.
Type annotations and code completion for boto3.client("cognito-idp").describe_risk_configuration
method.
boto3 documentation
# describe_risk_configuration method definition
def describe_risk_configuration(
self,
*,
UserPoolId: str,
ClientId: str = ...,
) -> DescribeRiskConfigurationResponseTypeDef: # (1)
...
# describe_risk_configuration method usage example with argument unpacking
kwargs: DescribeRiskConfigurationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.describe_risk_configuration(**kwargs)
describe_user_import_job#
Describes a user import job.
Type annotations and code completion for boto3.client("cognito-idp").describe_user_import_job
method.
boto3 documentation
# describe_user_import_job method definition
def describe_user_import_job(
self,
*,
UserPoolId: str,
JobId: str,
) -> DescribeUserImportJobResponseTypeDef: # (1)
...
# describe_user_import_job method usage example with argument unpacking
kwargs: DescribeUserImportJobRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"JobId": ...,
}
parent.describe_user_import_job(**kwargs)
describe_user_pool#
Given a user pool ID, returns configuration information.
Type annotations and code completion for boto3.client("cognito-idp").describe_user_pool
method.
boto3 documentation
# describe_user_pool method definition
def describe_user_pool(
self,
*,
UserPoolId: str,
) -> DescribeUserPoolResponseTypeDef: # (1)
...
# describe_user_pool method usage example with argument unpacking
kwargs: DescribeUserPoolRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.describe_user_pool(**kwargs)
describe_user_pool_client#
Given an app client ID, returns configuration information.
Type annotations and code completion for boto3.client("cognito-idp").describe_user_pool_client
method.
boto3 documentation
# describe_user_pool_client method definition
def describe_user_pool_client(
self,
*,
UserPoolId: str,
ClientId: str,
) -> DescribeUserPoolClientResponseTypeDef: # (1)
...
# describe_user_pool_client method usage example with argument unpacking
kwargs: DescribeUserPoolClientRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
}
parent.describe_user_pool_client(**kwargs)
describe_user_pool_domain#
Given a user pool domain name, returns information about the domain configuration.
Type annotations and code completion for boto3.client("cognito-idp").describe_user_pool_domain
method.
boto3 documentation
# describe_user_pool_domain method definition
def describe_user_pool_domain(
self,
*,
Domain: str,
) -> DescribeUserPoolDomainResponseTypeDef: # (1)
...
# describe_user_pool_domain method usage example with argument unpacking
kwargs: DescribeUserPoolDomainRequestRequestTypeDef = { # (1)
"Domain": ...,
}
parent.describe_user_pool_domain(**kwargs)
forget_device#
Forgets the specified device.
Type annotations and code completion for boto3.client("cognito-idp").forget_device
method.
boto3 documentation
# forget_device method definition
def forget_device(
self,
*,
DeviceKey: str,
AccessToken: str = ...,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# forget_device method usage example with argument unpacking
kwargs: ForgetDeviceRequestRequestTypeDef = { # (1)
"DeviceKey": ...,
}
parent.forget_device(**kwargs)
forgot_password#
Calling this API causes a message to be sent to the end user with a confirmation code that is required to change the user's password.
Type annotations and code completion for boto3.client("cognito-idp").forgot_password
method.
boto3 documentation
# forgot_password method definition
def forgot_password(
self,
*,
ClientId: str,
Username: str,
SecretHash: str = ...,
UserContextData: UserContextDataTypeTypeDef = ..., # (1)
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
ClientMetadata: Mapping[str, str] = ...,
) -> ForgotPasswordResponseTypeDef: # (3)
...
# forgot_password method usage example with argument unpacking
kwargs: ForgotPasswordRequestRequestTypeDef = { # (1)
"ClientId": ...,
"Username": ...,
}
parent.forgot_password(**kwargs)
get_csv_header#
Gets the header information for the comma-separated value (CSV) file to be used as input for the user import job.
Type annotations and code completion for boto3.client("cognito-idp").get_csv_header
method.
boto3 documentation
# get_csv_header method definition
def get_csv_header(
self,
*,
UserPoolId: str,
) -> GetCSVHeaderResponseTypeDef: # (1)
...
# get_csv_header method usage example with argument unpacking
kwargs: GetCSVHeaderRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.get_csv_header(**kwargs)
get_device#
Gets the device.
Type annotations and code completion for boto3.client("cognito-idp").get_device
method.
boto3 documentation
# get_device method definition
def get_device(
self,
*,
DeviceKey: str,
AccessToken: str = ...,
) -> GetDeviceResponseTypeDef: # (1)
...
# get_device method usage example with argument unpacking
kwargs: GetDeviceRequestRequestTypeDef = { # (1)
"DeviceKey": ...,
}
parent.get_device(**kwargs)
get_group#
Gets a group.
Type annotations and code completion for boto3.client("cognito-idp").get_group
method.
boto3 documentation
# get_group method definition
def get_group(
self,
*,
GroupName: str,
UserPoolId: str,
) -> GetGroupResponseTypeDef: # (1)
...
# get_group method usage example with argument unpacking
kwargs: GetGroupRequestRequestTypeDef = { # (1)
"GroupName": ...,
"UserPoolId": ...,
}
parent.get_group(**kwargs)
get_identity_provider_by_identifier#
Gets the specified IdP.
Type annotations and code completion for boto3.client("cognito-idp").get_identity_provider_by_identifier
method.
boto3 documentation
# get_identity_provider_by_identifier method definition
def get_identity_provider_by_identifier(
self,
*,
UserPoolId: str,
IdpIdentifier: str,
) -> GetIdentityProviderByIdentifierResponseTypeDef: # (1)
...
# get_identity_provider_by_identifier method usage example with argument unpacking
kwargs: GetIdentityProviderByIdentifierRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"IdpIdentifier": ...,
}
parent.get_identity_provider_by_identifier(**kwargs)
get_log_delivery_configuration#
Gets the logging configuration of a user pool.
Type annotations and code completion for boto3.client("cognito-idp").get_log_delivery_configuration
method.
boto3 documentation
# get_log_delivery_configuration method definition
def get_log_delivery_configuration(
self,
*,
UserPoolId: str,
) -> GetLogDeliveryConfigurationResponseTypeDef: # (1)
...
# get_log_delivery_configuration method usage example with argument unpacking
kwargs: GetLogDeliveryConfigurationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.get_log_delivery_configuration(**kwargs)
get_signing_certificate#
This method takes a user pool ID, and returns the signing certificate.
Type annotations and code completion for boto3.client("cognito-idp").get_signing_certificate
method.
boto3 documentation
# get_signing_certificate method definition
def get_signing_certificate(
self,
*,
UserPoolId: str,
) -> GetSigningCertificateResponseTypeDef: # (1)
...
# get_signing_certificate method usage example with argument unpacking
kwargs: GetSigningCertificateRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.get_signing_certificate(**kwargs)
get_ui_customization#
Gets the user interface (UI) Customization information for a particular app client's app UI, if any such information exists for the client.
Type annotations and code completion for boto3.client("cognito-idp").get_ui_customization
method.
boto3 documentation
# get_ui_customization method definition
def get_ui_customization(
self,
*,
UserPoolId: str,
ClientId: str = ...,
) -> GetUICustomizationResponseTypeDef: # (1)
...
# get_ui_customization method usage example with argument unpacking
kwargs: GetUICustomizationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.get_ui_customization(**kwargs)
get_user#
Gets the user attributes and metadata for a user.
Type annotations and code completion for boto3.client("cognito-idp").get_user
method.
boto3 documentation
# get_user method definition
def get_user(
self,
*,
AccessToken: str,
) -> GetUserResponseTypeDef: # (1)
...
# get_user method usage example with argument unpacking
kwargs: GetUserRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.get_user(**kwargs)
get_user_attribute_verification_code#
Generates a user attribute verification code for the specified attribute name.
Type annotations and code completion for boto3.client("cognito-idp").get_user_attribute_verification_code
method.
boto3 documentation
# get_user_attribute_verification_code method definition
def get_user_attribute_verification_code(
self,
*,
AccessToken: str,
AttributeName: str,
ClientMetadata: Mapping[str, str] = ...,
) -> GetUserAttributeVerificationCodeResponseTypeDef: # (1)
...
# get_user_attribute_verification_code method usage example with argument unpacking
kwargs: GetUserAttributeVerificationCodeRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"AttributeName": ...,
}
parent.get_user_attribute_verification_code(**kwargs)
get_user_auth_factors#
Lists the authentication options for the currently signed-in user.
Type annotations and code completion for boto3.client("cognito-idp").get_user_auth_factors
method.
boto3 documentation
# get_user_auth_factors method definition
def get_user_auth_factors(
self,
*,
AccessToken: str,
) -> GetUserAuthFactorsResponseTypeDef: # (1)
...
# get_user_auth_factors method usage example with argument unpacking
kwargs: GetUserAuthFactorsRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.get_user_auth_factors(**kwargs)
get_user_pool_mfa_config#
Gets the user pool multi-factor authentication (MFA) configuration.
Type annotations and code completion for boto3.client("cognito-idp").get_user_pool_mfa_config
method.
boto3 documentation
# get_user_pool_mfa_config method definition
def get_user_pool_mfa_config(
self,
*,
UserPoolId: str,
) -> GetUserPoolMfaConfigResponseTypeDef: # (1)
...
# get_user_pool_mfa_config method usage example with argument unpacking
kwargs: GetUserPoolMfaConfigRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.get_user_pool_mfa_config(**kwargs)
global_sign_out#
Invalidates the identity, access, and refresh tokens that Amazon Cognito issued to a user.
Type annotations and code completion for boto3.client("cognito-idp").global_sign_out
method.
boto3 documentation
# global_sign_out method definition
def global_sign_out(
self,
*,
AccessToken: str,
) -> dict[str, Any]:
...
# global_sign_out method usage example with argument unpacking
kwargs: GlobalSignOutRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.global_sign_out(**kwargs)
initiate_auth#
Initiates sign-in for a user in the Amazon Cognito user directory.
Type annotations and code completion for boto3.client("cognito-idp").initiate_auth
method.
boto3 documentation
# initiate_auth method definition
def initiate_auth(
self,
*,
AuthFlow: AuthFlowTypeType, # (1)
ClientId: str,
AuthParameters: Mapping[str, str] = ...,
ClientMetadata: Mapping[str, str] = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
UserContextData: UserContextDataTypeTypeDef = ..., # (3)
Session: str = ...,
) -> InitiateAuthResponseTypeDef: # (4)
...
- See AuthFlowTypeType
- See AnalyticsMetadataTypeTypeDef
- See UserContextDataTypeTypeDef
- See InitiateAuthResponseTypeDef
# initiate_auth method usage example with argument unpacking
kwargs: InitiateAuthRequestRequestTypeDef = { # (1)
"AuthFlow": ...,
"ClientId": ...,
}
parent.initiate_auth(**kwargs)
list_devices#
Lists the sign-in devices that Amazon Cognito has registered to the current user.
Type annotations and code completion for boto3.client("cognito-idp").list_devices
method.
boto3 documentation
# list_devices method definition
def list_devices(
self,
*,
AccessToken: str,
Limit: int = ...,
PaginationToken: str = ...,
) -> ListDevicesResponseTypeDef: # (1)
...
# list_devices method usage example with argument unpacking
kwargs: ListDevicesRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.list_devices(**kwargs)
list_groups#
Lists the groups associated with a user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_groups
method.
boto3 documentation
# list_groups method definition
def list_groups(
self,
*,
UserPoolId: str,
Limit: int = ...,
NextToken: str = ...,
) -> ListGroupsResponseTypeDef: # (1)
...
# list_groups method usage example with argument unpacking
kwargs: ListGroupsRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.list_groups(**kwargs)
list_identity_providers#
Lists information about all IdPs for a user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_identity_providers
method.
boto3 documentation
# list_identity_providers method definition
def list_identity_providers(
self,
*,
UserPoolId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListIdentityProvidersResponseTypeDef: # (1)
...
# list_identity_providers method usage example with argument unpacking
kwargs: ListIdentityProvidersRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.list_identity_providers(**kwargs)
list_resource_servers#
Lists the resource servers for a user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_resource_servers
method.
boto3 documentation
# list_resource_servers method definition
def list_resource_servers(
self,
*,
UserPoolId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListResourceServersResponseTypeDef: # (1)
...
# list_resource_servers method usage example with argument unpacking
kwargs: ListResourceServersRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.list_resource_servers(**kwargs)
list_tags_for_resource#
Lists the tags that are assigned to an Amazon Cognito user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_tags_for_resource
method.
boto3 documentation
# list_tags_for_resource method definition
def list_tags_for_resource(
self,
*,
ResourceArn: str,
) -> ListTagsForResourceResponseTypeDef: # (1)
...
# list_tags_for_resource method usage example with argument unpacking
kwargs: ListTagsForResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
}
parent.list_tags_for_resource(**kwargs)
list_user_import_jobs#
Lists user import jobs for a user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_user_import_jobs
method.
boto3 documentation
# list_user_import_jobs method definition
def list_user_import_jobs(
self,
*,
UserPoolId: str,
MaxResults: int,
PaginationToken: str = ...,
) -> ListUserImportJobsResponseTypeDef: # (1)
...
# list_user_import_jobs method usage example with argument unpacking
kwargs: ListUserImportJobsRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"MaxResults": ...,
}
parent.list_user_import_jobs(**kwargs)
list_user_pool_clients#
Lists the clients that have been created for the specified user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_user_pool_clients
method.
boto3 documentation
# list_user_pool_clients method definition
def list_user_pool_clients(
self,
*,
UserPoolId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListUserPoolClientsResponseTypeDef: # (1)
...
# list_user_pool_clients method usage example with argument unpacking
kwargs: ListUserPoolClientsRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.list_user_pool_clients(**kwargs)
list_user_pools#
Lists the user pools associated with an Amazon Web Services account.
Type annotations and code completion for boto3.client("cognito-idp").list_user_pools
method.
boto3 documentation
# list_user_pools method definition
def list_user_pools(
self,
*,
MaxResults: int,
NextToken: str = ...,
) -> ListUserPoolsResponseTypeDef: # (1)
...
# list_user_pools method usage example with argument unpacking
kwargs: ListUserPoolsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_user_pools(**kwargs)
list_users#
Lists users and their basic details in a user pool.
Type annotations and code completion for boto3.client("cognito-idp").list_users
method.
boto3 documentation
# list_users method definition
def list_users(
self,
*,
UserPoolId: str,
AttributesToGet: Sequence[str] = ...,
Limit: int = ...,
PaginationToken: str = ...,
Filter: str = ...,
) -> ListUsersResponseTypeDef: # (1)
...
# list_users method usage example with argument unpacking
kwargs: ListUsersRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.list_users(**kwargs)
list_users_in_group#
Lists the users in the specified group.
Type annotations and code completion for boto3.client("cognito-idp").list_users_in_group
method.
boto3 documentation
# list_users_in_group method definition
def list_users_in_group(
self,
*,
UserPoolId: str,
GroupName: str,
Limit: int = ...,
NextToken: str = ...,
) -> ListUsersInGroupResponseTypeDef: # (1)
...
# list_users_in_group method usage example with argument unpacking
kwargs: ListUsersInGroupRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"GroupName": ...,
}
parent.list_users_in_group(**kwargs)
list_web_authn_credentials#
Generates a list of the current user's registered passkey, or webauthN, credentials.
Type annotations and code completion for boto3.client("cognito-idp").list_web_authn_credentials
method.
boto3 documentation
# list_web_authn_credentials method definition
def list_web_authn_credentials(
self,
*,
AccessToken: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListWebAuthnCredentialsResponseTypeDef: # (1)
...
# list_web_authn_credentials method usage example with argument unpacking
kwargs: ListWebAuthnCredentialsRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.list_web_authn_credentials(**kwargs)
resend_confirmation_code#
Resends the confirmation (for confirmation of registration) to a specific user in the user pool.
Type annotations and code completion for boto3.client("cognito-idp").resend_confirmation_code
method.
boto3 documentation
# resend_confirmation_code method definition
def resend_confirmation_code(
self,
*,
ClientId: str,
Username: str,
SecretHash: str = ...,
UserContextData: UserContextDataTypeTypeDef = ..., # (1)
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
ClientMetadata: Mapping[str, str] = ...,
) -> ResendConfirmationCodeResponseTypeDef: # (3)
...
- See UserContextDataTypeTypeDef
- See AnalyticsMetadataTypeTypeDef
- See ResendConfirmationCodeResponseTypeDef
# resend_confirmation_code method usage example with argument unpacking
kwargs: ResendConfirmationCodeRequestRequestTypeDef = { # (1)
"ClientId": ...,
"Username": ...,
}
parent.resend_confirmation_code(**kwargs)
respond_to_auth_challenge#
Some API operations in a user pool generate a challenge, like a prompt for an MFA code, for device authentication that bypasses MFA, or for a custom authentication challenge.
Type annotations and code completion for boto3.client("cognito-idp").respond_to_auth_challenge
method.
boto3 documentation
# respond_to_auth_challenge method definition
def respond_to_auth_challenge(
self,
*,
ClientId: str,
ChallengeName: ChallengeNameTypeType, # (1)
Session: str = ...,
ChallengeResponses: Mapping[str, str] = ...,
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (2)
UserContextData: UserContextDataTypeTypeDef = ..., # (3)
ClientMetadata: Mapping[str, str] = ...,
) -> RespondToAuthChallengeResponseTypeDef: # (4)
...
- See ChallengeNameTypeType
- See AnalyticsMetadataTypeTypeDef
- See UserContextDataTypeTypeDef
- See RespondToAuthChallengeResponseTypeDef
# respond_to_auth_challenge method usage example with argument unpacking
kwargs: RespondToAuthChallengeRequestRequestTypeDef = { # (1)
"ClientId": ...,
"ChallengeName": ...,
}
parent.respond_to_auth_challenge(**kwargs)
revoke_token#
Revokes all of the access tokens generated by, and at the same time as, the specified refresh token.
Type annotations and code completion for boto3.client("cognito-idp").revoke_token
method.
boto3 documentation
# revoke_token method definition
def revoke_token(
self,
*,
Token: str,
ClientId: str,
ClientSecret: str = ...,
) -> dict[str, Any]:
...
# revoke_token method usage example with argument unpacking
kwargs: RevokeTokenRequestRequestTypeDef = { # (1)
"Token": ...,
"ClientId": ...,
}
parent.revoke_token(**kwargs)
set_log_delivery_configuration#
Sets up or modifies the logging configuration of a user pool.
Type annotations and code completion for boto3.client("cognito-idp").set_log_delivery_configuration
method.
boto3 documentation
# set_log_delivery_configuration method definition
def set_log_delivery_configuration(
self,
*,
UserPoolId: str,
LogConfigurations: Sequence[LogConfigurationTypeTypeDef], # (1)
) -> SetLogDeliveryConfigurationResponseTypeDef: # (2)
...
# set_log_delivery_configuration method usage example with argument unpacking
kwargs: SetLogDeliveryConfigurationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"LogConfigurations": ...,
}
parent.set_log_delivery_configuration(**kwargs)
set_risk_configuration#
Configures actions on detected risks.
Type annotations and code completion for boto3.client("cognito-idp").set_risk_configuration
method.
boto3 documentation
# set_risk_configuration method definition
def set_risk_configuration(
self,
*,
UserPoolId: str,
ClientId: str = ...,
CompromisedCredentialsRiskConfiguration: CompromisedCredentialsRiskConfigurationTypeTypeDef = ..., # (1)
AccountTakeoverRiskConfiguration: AccountTakeoverRiskConfigurationTypeTypeDef = ..., # (2)
RiskExceptionConfiguration: RiskExceptionConfigurationTypeTypeDef = ..., # (3)
) -> SetRiskConfigurationResponseTypeDef: # (4)
...
- See CompromisedCredentialsRiskConfigurationTypeTypeDef
- See AccountTakeoverRiskConfigurationTypeTypeDef
- See RiskExceptionConfigurationTypeTypeDef
- See SetRiskConfigurationResponseTypeDef
# set_risk_configuration method usage example with argument unpacking
kwargs: SetRiskConfigurationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.set_risk_configuration(**kwargs)
set_ui_customization#
Sets the user interface (UI) customization information for a user pool's built-in app UI.
Type annotations and code completion for boto3.client("cognito-idp").set_ui_customization
method.
boto3 documentation
# set_ui_customization method definition
def set_ui_customization(
self,
*,
UserPoolId: str,
ClientId: str = ...,
CSS: str = ...,
ImageFile: BlobTypeDef = ...,
) -> SetUICustomizationResponseTypeDef: # (1)
...
# set_ui_customization method usage example with argument unpacking
kwargs: SetUICustomizationRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.set_ui_customization(**kwargs)
set_user_mfa_preference#
Set the user's multi-factor authentication (MFA) method preference, including which MFA factors are activated and if any are preferred.
Type annotations and code completion for boto3.client("cognito-idp").set_user_mfa_preference
method.
boto3 documentation
# set_user_mfa_preference method definition
def set_user_mfa_preference(
self,
*,
AccessToken: str,
SMSMfaSettings: SMSMfaSettingsTypeTypeDef = ..., # (1)
SoftwareTokenMfaSettings: SoftwareTokenMfaSettingsTypeTypeDef = ..., # (2)
EmailMfaSettings: EmailMfaSettingsTypeTypeDef = ..., # (3)
) -> dict[str, Any]:
...
- See SMSMfaSettingsTypeTypeDef
- See SoftwareTokenMfaSettingsTypeTypeDef
- See EmailMfaSettingsTypeTypeDef
# set_user_mfa_preference method usage example with argument unpacking
kwargs: SetUserMFAPreferenceRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.set_user_mfa_preference(**kwargs)
set_user_pool_mfa_config#
Sets the user pool multi-factor authentication (MFA) and passkey configuration.
Type annotations and code completion for boto3.client("cognito-idp").set_user_pool_mfa_config
method.
boto3 documentation
# set_user_pool_mfa_config method definition
def set_user_pool_mfa_config(
self,
*,
UserPoolId: str,
SmsMfaConfiguration: SmsMfaConfigTypeTypeDef = ..., # (1)
SoftwareTokenMfaConfiguration: SoftwareTokenMfaConfigTypeTypeDef = ..., # (2)
EmailMfaConfiguration: EmailMfaConfigTypeTypeDef = ..., # (3)
MfaConfiguration: UserPoolMfaTypeType = ..., # (4)
WebAuthnConfiguration: WebAuthnConfigurationTypeTypeDef = ..., # (5)
) -> SetUserPoolMfaConfigResponseTypeDef: # (6)
...
- See SmsMfaConfigTypeTypeDef
- See SoftwareTokenMfaConfigTypeTypeDef
- See EmailMfaConfigTypeTypeDef
- See UserPoolMfaTypeType
- See WebAuthnConfigurationTypeTypeDef
- See SetUserPoolMfaConfigResponseTypeDef
# set_user_pool_mfa_config method usage example with argument unpacking
kwargs: SetUserPoolMfaConfigRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.set_user_pool_mfa_config(**kwargs)
set_user_settings#
This action is no longer supported. You can use it to configure only SMS MFA.
Type annotations and code completion for boto3.client("cognito-idp").set_user_settings
method.
boto3 documentation
# set_user_settings method definition
def set_user_settings(
self,
*,
AccessToken: str,
MFAOptions: Sequence[MFAOptionTypeTypeDef], # (1)
) -> dict[str, Any]:
...
# set_user_settings method usage example with argument unpacking
kwargs: SetUserSettingsRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"MFAOptions": ...,
}
parent.set_user_settings(**kwargs)
sign_up#
Registers the user in the specified user pool and creates a user name, password, and user attributes.
Type annotations and code completion for boto3.client("cognito-idp").sign_up
method.
boto3 documentation
# sign_up method definition
def sign_up(
self,
*,
ClientId: str,
Username: str,
SecretHash: str = ...,
Password: str = ...,
UserAttributes: Sequence[AttributeTypeTypeDef] = ..., # (1)
ValidationData: Sequence[AttributeTypeTypeDef] = ..., # (1)
AnalyticsMetadata: AnalyticsMetadataTypeTypeDef = ..., # (3)
UserContextData: UserContextDataTypeTypeDef = ..., # (4)
ClientMetadata: Mapping[str, str] = ...,
) -> SignUpResponseTypeDef: # (5)
...
- See AttributeTypeTypeDef
- See AttributeTypeTypeDef
- See AnalyticsMetadataTypeTypeDef
- See UserContextDataTypeTypeDef
- See SignUpResponseTypeDef
# sign_up method usage example with argument unpacking
kwargs: SignUpRequestRequestTypeDef = { # (1)
"ClientId": ...,
"Username": ...,
}
parent.sign_up(**kwargs)
start_user_import_job#
Starts the user import.
Type annotations and code completion for boto3.client("cognito-idp").start_user_import_job
method.
boto3 documentation
# start_user_import_job method definition
def start_user_import_job(
self,
*,
UserPoolId: str,
JobId: str,
) -> StartUserImportJobResponseTypeDef: # (1)
...
# start_user_import_job method usage example with argument unpacking
kwargs: StartUserImportJobRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"JobId": ...,
}
parent.start_user_import_job(**kwargs)
start_web_authn_registration#
Requests credential creation options from your user pool for registration of a passkey authenticator.
Type annotations and code completion for boto3.client("cognito-idp").start_web_authn_registration
method.
boto3 documentation
# start_web_authn_registration method definition
def start_web_authn_registration(
self,
*,
AccessToken: str,
) -> StartWebAuthnRegistrationResponseTypeDef: # (1)
...
# start_web_authn_registration method usage example with argument unpacking
kwargs: StartWebAuthnRegistrationRequestRequestTypeDef = { # (1)
"AccessToken": ...,
}
parent.start_web_authn_registration(**kwargs)
stop_user_import_job#
Stops the user import job.
Type annotations and code completion for boto3.client("cognito-idp").stop_user_import_job
method.
boto3 documentation
# stop_user_import_job method definition
def stop_user_import_job(
self,
*,
UserPoolId: str,
JobId: str,
) -> StopUserImportJobResponseTypeDef: # (1)
...
# stop_user_import_job method usage example with argument unpacking
kwargs: StopUserImportJobRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"JobId": ...,
}
parent.stop_user_import_job(**kwargs)
tag_resource#
Assigns a set of tags to an Amazon Cognito user pool.
Type annotations and code completion for boto3.client("cognito-idp").tag_resource
method.
boto3 documentation
# tag_resource method definition
def tag_resource(
self,
*,
ResourceArn: str,
Tags: Mapping[str, str],
) -> dict[str, Any]:
...
# tag_resource method usage example with argument unpacking
kwargs: TagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"Tags": ...,
}
parent.tag_resource(**kwargs)
untag_resource#
Removes the specified tags from an Amazon Cognito user pool.
Type annotations and code completion for boto3.client("cognito-idp").untag_resource
method.
boto3 documentation
# untag_resource method definition
def untag_resource(
self,
*,
ResourceArn: str,
TagKeys: Sequence[str],
) -> dict[str, Any]:
...
# untag_resource method usage example with argument unpacking
kwargs: UntagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"TagKeys": ...,
}
parent.untag_resource(**kwargs)
update_auth_event_feedback#
Provides the feedback for an authentication event, whether it was from a valid user or not.
Type annotations and code completion for boto3.client("cognito-idp").update_auth_event_feedback
method.
boto3 documentation
# update_auth_event_feedback method definition
def update_auth_event_feedback(
self,
*,
UserPoolId: str,
Username: str,
EventId: str,
FeedbackToken: str,
FeedbackValue: FeedbackValueTypeType, # (1)
) -> dict[str, Any]:
...
# update_auth_event_feedback method usage example with argument unpacking
kwargs: UpdateAuthEventFeedbackRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Username": ...,
"EventId": ...,
"FeedbackToken": ...,
"FeedbackValue": ...,
}
parent.update_auth_event_feedback(**kwargs)
update_device_status#
Updates the device status.
Type annotations and code completion for boto3.client("cognito-idp").update_device_status
method.
boto3 documentation
# update_device_status method definition
def update_device_status(
self,
*,
AccessToken: str,
DeviceKey: str,
DeviceRememberedStatus: DeviceRememberedStatusTypeType = ..., # (1)
) -> dict[str, Any]:
...
# update_device_status method usage example with argument unpacking
kwargs: UpdateDeviceStatusRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"DeviceKey": ...,
}
parent.update_device_status(**kwargs)
update_group#
Updates the specified group with the specified attributes.
Type annotations and code completion for boto3.client("cognito-idp").update_group
method.
boto3 documentation
# update_group method definition
def update_group(
self,
*,
GroupName: str,
UserPoolId: str,
Description: str = ...,
RoleArn: str = ...,
Precedence: int = ...,
) -> UpdateGroupResponseTypeDef: # (1)
...
# update_group method usage example with argument unpacking
kwargs: UpdateGroupRequestRequestTypeDef = { # (1)
"GroupName": ...,
"UserPoolId": ...,
}
parent.update_group(**kwargs)
update_identity_provider#
Updates IdP information for a user pool.
Type annotations and code completion for boto3.client("cognito-idp").update_identity_provider
method.
boto3 documentation
# update_identity_provider method definition
def update_identity_provider(
self,
*,
UserPoolId: str,
ProviderName: str,
ProviderDetails: Mapping[str, str] = ...,
AttributeMapping: Mapping[str, str] = ...,
IdpIdentifiers: Sequence[str] = ...,
) -> UpdateIdentityProviderResponseTypeDef: # (1)
...
# update_identity_provider method usage example with argument unpacking
kwargs: UpdateIdentityProviderRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ProviderName": ...,
}
parent.update_identity_provider(**kwargs)
update_managed_login_branding#
Configures the branding settings for a user pool style.
Type annotations and code completion for boto3.client("cognito-idp").update_managed_login_branding
method.
boto3 documentation
# update_managed_login_branding method definition
def update_managed_login_branding(
self,
*,
UserPoolId: str = ...,
ManagedLoginBrandingId: str = ...,
UseCognitoProvidedValues: bool = ...,
Settings: Mapping[str, Any] = ...,
Assets: Sequence[AssetTypeTypeDef] = ..., # (1)
) -> UpdateManagedLoginBrandingResponseTypeDef: # (2)
...
# update_managed_login_branding method usage example with argument unpacking
kwargs: UpdateManagedLoginBrandingRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.update_managed_login_branding(**kwargs)
update_resource_server#
Updates the name and scopes of resource server.
Type annotations and code completion for boto3.client("cognito-idp").update_resource_server
method.
boto3 documentation
# update_resource_server method definition
def update_resource_server(
self,
*,
UserPoolId: str,
Identifier: str,
Name: str,
Scopes: Sequence[ResourceServerScopeTypeTypeDef] = ..., # (1)
) -> UpdateResourceServerResponseTypeDef: # (2)
...
# update_resource_server method usage example with argument unpacking
kwargs: UpdateResourceServerRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"Identifier": ...,
"Name": ...,
}
parent.update_resource_server(**kwargs)
update_user_attributes#
With this operation, your users can update one or more of their attributes with their own credentials.
Type annotations and code completion for boto3.client("cognito-idp").update_user_attributes
method.
boto3 documentation
# update_user_attributes method definition
def update_user_attributes(
self,
*,
UserAttributes: Sequence[AttributeTypeTypeDef], # (1)
AccessToken: str,
ClientMetadata: Mapping[str, str] = ...,
) -> UpdateUserAttributesResponseTypeDef: # (2)
...
# update_user_attributes method usage example with argument unpacking
kwargs: UpdateUserAttributesRequestRequestTypeDef = { # (1)
"UserAttributes": ...,
"AccessToken": ...,
}
parent.update_user_attributes(**kwargs)
update_user_pool#
This action might generate an SMS text message.
Type annotations and code completion for boto3.client("cognito-idp").update_user_pool
method.
boto3 documentation
# update_user_pool method definition
def update_user_pool(
self,
*,
UserPoolId: str,
Policies: UserPoolPolicyTypeTypeDef = ..., # (1)
DeletionProtection: DeletionProtectionTypeType = ..., # (2)
LambdaConfig: LambdaConfigTypeTypeDef = ..., # (3)
AutoVerifiedAttributes: Sequence[VerifiedAttributeTypeType] = ..., # (4)
SmsVerificationMessage: str = ...,
EmailVerificationMessage: str = ...,
EmailVerificationSubject: str = ...,
VerificationMessageTemplate: VerificationMessageTemplateTypeTypeDef = ..., # (5)
SmsAuthenticationMessage: str = ...,
UserAttributeUpdateSettings: UserAttributeUpdateSettingsTypeTypeDef = ..., # (6)
MfaConfiguration: UserPoolMfaTypeType = ..., # (7)
DeviceConfiguration: DeviceConfigurationTypeTypeDef = ..., # (8)
EmailConfiguration: EmailConfigurationTypeTypeDef = ..., # (9)
SmsConfiguration: SmsConfigurationTypeTypeDef = ..., # (10)
UserPoolTags: Mapping[str, str] = ...,
AdminCreateUserConfig: AdminCreateUserConfigTypeTypeDef = ..., # (11)
UserPoolAddOns: UserPoolAddOnsTypeTypeDef = ..., # (12)
AccountRecoverySetting: AccountRecoverySettingTypeTypeDef = ..., # (13)
PoolName: str = ...,
UserPoolTier: UserPoolTierTypeType = ..., # (14)
) -> dict[str, Any]:
...
- See UserPoolPolicyTypeTypeDef
- See DeletionProtectionTypeType
- See LambdaConfigTypeTypeDef
- See VerifiedAttributeTypeType
- See VerificationMessageTemplateTypeTypeDef
- See UserAttributeUpdateSettingsTypeTypeDef
- See UserPoolMfaTypeType
- See DeviceConfigurationTypeTypeDef
- See EmailConfigurationTypeTypeDef
- See SmsConfigurationTypeTypeDef
- See AdminCreateUserConfigTypeTypeDef
- See UserPoolAddOnsTypeTypeDef
- See AccountRecoverySettingTypeTypeDef
- See UserPoolTierTypeType
# update_user_pool method usage example with argument unpacking
kwargs: UpdateUserPoolRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
}
parent.update_user_pool(**kwargs)
update_user_pool_client#
Updates the specified user pool app client with the specified attributes.
Type annotations and code completion for boto3.client("cognito-idp").update_user_pool_client
method.
boto3 documentation
# update_user_pool_client method definition
def update_user_pool_client(
self,
*,
UserPoolId: str,
ClientId: str,
ClientName: str = ...,
RefreshTokenValidity: int = ...,
AccessTokenValidity: int = ...,
IdTokenValidity: int = ...,
TokenValidityUnits: TokenValidityUnitsTypeTypeDef = ..., # (1)
ReadAttributes: Sequence[str] = ...,
WriteAttributes: Sequence[str] = ...,
ExplicitAuthFlows: Sequence[ExplicitAuthFlowsTypeType] = ..., # (2)
SupportedIdentityProviders: Sequence[str] = ...,
CallbackURLs: Sequence[str] = ...,
LogoutURLs: Sequence[str] = ...,
DefaultRedirectURI: str = ...,
AllowedOAuthFlows: Sequence[OAuthFlowTypeType] = ..., # (3)
AllowedOAuthScopes: Sequence[str] = ...,
AllowedOAuthFlowsUserPoolClient: bool = ...,
AnalyticsConfiguration: AnalyticsConfigurationTypeTypeDef = ..., # (4)
PreventUserExistenceErrors: PreventUserExistenceErrorTypesType = ..., # (5)
EnableTokenRevocation: bool = ...,
EnablePropagateAdditionalUserContextData: bool = ...,
AuthSessionValidity: int = ...,
) -> UpdateUserPoolClientResponseTypeDef: # (6)
...
- See TokenValidityUnitsTypeTypeDef
- See ExplicitAuthFlowsTypeType
- See OAuthFlowTypeType
- See AnalyticsConfigurationTypeTypeDef
- See PreventUserExistenceErrorTypesType
- See UpdateUserPoolClientResponseTypeDef
# update_user_pool_client method usage example with argument unpacking
kwargs: UpdateUserPoolClientRequestRequestTypeDef = { # (1)
"UserPoolId": ...,
"ClientId": ...,
}
parent.update_user_pool_client(**kwargs)
update_user_pool_domain#
A user pool domain hosts managed login, an authorization server and web server for authentication in your application.
Type annotations and code completion for boto3.client("cognito-idp").update_user_pool_domain
method.
boto3 documentation
# update_user_pool_domain method definition
def update_user_pool_domain(
self,
*,
Domain: str,
UserPoolId: str,
ManagedLoginVersion: int = ...,
CustomDomainConfig: CustomDomainConfigTypeTypeDef = ..., # (1)
) -> UpdateUserPoolDomainResponseTypeDef: # (2)
...
# update_user_pool_domain method usage example with argument unpacking
kwargs: UpdateUserPoolDomainRequestRequestTypeDef = { # (1)
"Domain": ...,
"UserPoolId": ...,
}
parent.update_user_pool_domain(**kwargs)
verify_software_token#
Use this API to register a user's entered time-based one-time password (TOTP) code and mark the user's software token MFA status as "verified" if successful.
Type annotations and code completion for boto3.client("cognito-idp").verify_software_token
method.
boto3 documentation
# verify_software_token method definition
def verify_software_token(
self,
*,
UserCode: str,
AccessToken: str = ...,
Session: str = ...,
FriendlyDeviceName: str = ...,
) -> VerifySoftwareTokenResponseTypeDef: # (1)
...
# verify_software_token method usage example with argument unpacking
kwargs: VerifySoftwareTokenRequestRequestTypeDef = { # (1)
"UserCode": ...,
}
parent.verify_software_token(**kwargs)
verify_user_attribute#
Verifies the specified user attributes in the user pool.
Type annotations and code completion for boto3.client("cognito-idp").verify_user_attribute
method.
boto3 documentation
# verify_user_attribute method definition
def verify_user_attribute(
self,
*,
AccessToken: str,
AttributeName: str,
Code: str,
) -> dict[str, Any]:
...
# verify_user_attribute method usage example with argument unpacking
kwargs: VerifyUserAttributeRequestRequestTypeDef = { # (1)
"AccessToken": ...,
"AttributeName": ...,
"Code": ...,
}
parent.verify_user_attribute(**kwargs)
get_paginator#
Type annotations and code completion for boto3.client("cognito-idp").get_paginator
method with overloads.
client.get_paginator("admin_list_groups_for_user")
-> AdminListGroupsForUserPaginatorclient.get_paginator("admin_list_user_auth_events")
-> AdminListUserAuthEventsPaginatorclient.get_paginator("list_groups")
-> ListGroupsPaginatorclient.get_paginator("list_identity_providers")
-> ListIdentityProvidersPaginatorclient.get_paginator("list_resource_servers")
-> ListResourceServersPaginatorclient.get_paginator("list_user_pool_clients")
-> ListUserPoolClientsPaginatorclient.get_paginator("list_user_pools")
-> ListUserPoolsPaginatorclient.get_paginator("list_users_in_group")
-> ListUsersInGroupPaginatorclient.get_paginator("list_users")
-> ListUsersPaginator