Keys / Cloudinary

CLOUDINARY_API_SECRET

The API secret your server signs Cloudinary API requests with. It pairs with an API key and a cloud name in one product environment.

Expires
no expiry setting
API
create, update and delete, with the Provisioning API on Enterprise plans

Get it

Create one on console.cloudinary.com/app/settings/api-keys. The steps aren't recorded yet.

Set it

CLOUDINARY_API_SECRET=...

The Python and Ruby SDKs read it when CLOUDINARY_CLOUD_NAME is also set. The Node.js, Go, PHP and Java SDKs read only CLOUDINARY_URL, which holds all three values. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. On Settings > API Keys, click Generate New API Key. Give it the same role as the old key.
  2. Deploy the new key and secret everywhere that reads CLOUDINARY_API_KEY and CLOUDINARY_API_SECRET, and in every CLOUDINARY_URL, which holds both.
  3. Check that everything works, then set the old key's Status to Disabled.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16