[Yandex Cloud documentation](../../index.md) > [Yandex Identity Hub](../index.md) > [Step-by-step guides](index.md) > Managing identity federations > Deleting an identity federation

# Deleting an identity federation

{% note info %}

To delete an identity federation, the user must have the `organization-manager.organizations.owner` [role](../security/index.md#organization-manager-organizations-owner).

{% endnote %}

To delete an identity federation:

{% list tabs group=instructions %}

- Cloud Center UI {#cloud-center}

  1. Log in to [Cloud Center](https://center.yandex.cloud) with an administrator or organization owner account.
  1. In the left-hand panel, select ![VectorSquare](../../_assets/console-icons/vector-square.svg) **Federations**.
  1. Next to the identity federation, click ![image](../../_assets/console-icons/ellipsis.svg) and select ![image](../../_assets/console-icons/trash-bin.svg) **Delete**.
  1. In the window that opens, confirm the deletion.

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../cli/quickstart.md#install).

  The folder used by default is the one specified when [creating](../../cli/operations/profile/profile-create.md) the CLI profile. To change the default folder, use the `yc config set folder-id <folder_ID>` command. You can also specify a different folder for any command using `--folder-name` or `--folder-id`. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. See the description of the command for deleting a Yandex Identity Hub user group:

      ```bash
      yc organization-manager federation saml delete --help
      ```

  1. Get a list of federations in the organization:

     ```bash
     yc organization-manager federation saml list \
       --organization-id <organization_ID>
     ```

     Where `--organization-id` is the [ID of the organization](organization-get-id.md) you need the list of federations for.
  
  1. To delete an identity federation, run this command:

      ```bash
      yc organization-manager federation saml delete <federation_name_or_ID>
      ```

- API {#api}

    Use the [Federation.delete](../saml/api-ref/Federation/delete.md) REST API method for the [Federation](../saml/api-ref/Federation/index.md) resource or the [FederationService/Delete](../saml/api-ref/grpc/Federation/delete.md) gRPC API call.

{% endlist %}