Authentication with the Container Registry API
Written by
Updated at October 9, 2026
Warning
Starting October 13, 2026, Yandex Container Registry will be unavailable to new users.
The existing users can create resources until November 10, 2026. Afterwards, Yandex Container Registry will go read-only and cease to operate on December 14, 2026. For more information on how it will be handled, see this article on Yandex Container Registry sunset.
Before you can work with the API, you need to get an IAM token:
- Guide for Yandex account.
- Guide for a service account.
- Guide for a federated account.
- Guide for a local account.
Specify the received IAM token when accessing Yandex Cloud resources via the API. Provide the IAM token in the Authorization header in the following format:
Authorization: Bearer <IAM_token>
If you have saved your IAM token to a variable, use the latter:
Authorization: Bearer ${IAM_TOKEN}