Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Identity and Access Management
    • All guides
    • Getting information about subjects
    • Processing secrets that have become publicly available
    • Users
    • User groups
      • Overview
        • Overview
        • Getting an IAM token for a Yandex account
        • Getting an IAM token for a service account
        • Getting an IAM token for a federated account
        • Getting an IAM token for a local user account
        • Revoking an IAM token
      • Managing static access keys
      • Managing API keys
      • Managing authorized keys
      • Creating a temporary access key using Security Token Service
      • Managing ephemeral access keys
  • Secure use of Yandex Cloud
  • Access management
  • Pricing policy
  • Role reference
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  1. Step-by-step guides
  2. Authentication
  3. IAM tokens
  4. Revoking an IAM token

Revoking an IAM token

Written by
Yandex Cloud
Updated at November 2, 2026
View in Markdown

You can revoke an IAM token you got earlier. For example, you may need to do so if your token is compromised or when getting a new IAM token.

To revoke an IAM token:

CLI
API

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating 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. View the description of the command for revoking an IAM token:

    yc iam revoke-token --help
    
  2. Revoke the IAM token by specifying it in this command:

    yc iam revoke-token \
      --iam-token "<IAM_token>"
    

    Result:

    subject_id: ajei280a73vc********
    

Run the following HTTP request, specifying the IAM token to revoke:

curl \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer <IAM_token>" \
  --data '{
      "iamToken": "<IAM_token>"
  }' \
  https://iam.api.cloud.yandex.net/iam/v1/tokens:revoke

Result:

{
  "subjectId": "ajei280a73vc********"
}

Useful linksUseful links

  • Getting an IAM token for a Yandex account
  • Getting an IAM token for a federated account
  • Getting an IAM token for a service account

Was the article helpful?

Previous
Getting an IAM token for a local user account
Next
Overview
© 2026 Direct Cursus Technology L.L.C.