Image & Video APIs

Role-based permissions via API

Last updated: Jun-30-2025

Use the Permissions API to programmatically manage access control across your Cloudinary account. The API allows you to create and assign roles and define custom permission policies.

This section covers:

  • Manage roles: How to manage roles via the Permissions API, including viewing, creating, updating, and assigning roles

  • Assign roles: How to assign roles to users, groups, and API keys via the Permissions API

  • Define custom policies: How to define and apply custom permission policies using the Cedar-based schema

    Important
    Custom policies give you fine-grained control, but they can behave in unexpected ways if not configured correctly. Review them carefully and test to make sure they align with your intended access rules.

Tip
To manage roles and permissions through the Console instead, see Manage roles and permissions in the Console.

✔️ Feedback sent!

Rate this page: