:doc:`CognitoIdentity <../../cognito-identity>` / Client / unlink_identity

***************
unlink_identity
***************



.. py:method:: CognitoIdentity.Client.unlink_identity(**kwargs)

  

  Unlinks a federated identity from an existing account. Unlinked logins will be considered new identities next time they are seen. Removing the last linked login will make this identity inaccessible.

   

  This is a public API. You do not need any credentials to call this API.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cognito-identity-2014-06-30/UnlinkIdentity>`_  


  **Request Syntax**
  ::

    response = client.unlink_identity(
        IdentityId='string',
        Logins={
            'string': 'string'
        },
        LoginsToRemove=[
            'string',
        ]
    )
    
  :type IdentityId: string
  :param IdentityId: **[REQUIRED]** 

    A unique identifier in the format REGION:GUID.

    

  
  :type Logins: dict
  :param Logins: **[REQUIRED]** 

    A set of optional name-value pairs that map provider names to provider tokens.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type LoginsToRemove: list
  :param LoginsToRemove: **[REQUIRED]** 

    Provider names to unlink from this identity.

    

  
    - *(string) --* 

    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`CognitoIdentity.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.NotAuthorizedException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.ResourceConflictException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.InternalErrorException`

  
  *   :py:class:`CognitoIdentity.Client.exceptions.ExternalServiceException`

  