You are viewing the Apigee Management API reference documentation. For the main product docs, and to search all docs, go to For cross-site search, click Search all in the search results.

Add Permissions for Resource to a Role

Resource Summary


Content Type



Permissions for Resource at Organization Level,



Add Permissions for Resource to a Role

In Apigee Edge, different user roles are assigned different permissions to view (GET), create or update (both PUT), or delete (DELETE) resources in an organization; for example, modifying API proxies or creating custom reports. Management users in those roles are limited to those specific permissions.

Permissions for a user role means assigning verbs to different resources for that role. For example, you can assign verb permissions to the /apis resource in Edge, which is the URI for working with API proxies. (Your organization in the Edge URL is considered the root.) For example,

Use this API to add resource permissions to a user role. You can use the * wild card in the URI pattern to indicate any value; for example, to include either the 'test' or 'prod' environment in the URI: /environments/*/cache.

Resource URL /organizations/{org_name}/userroles/{role_name}/permissions

Header Parameters

Name Values Description

Specify the content type

Request Body

org_name Mention the organization name true

role_name Mention the role name true

HTTP Basic

OAuth 2.0



Make a request and see the response.

Make a request and see the response.

Make a request and see the response.


Help or comments?

  • If something's not working: Ask the Apigee Community or see Apigee Support.
  • If something's wrong with the docs: Click the "Send Feedback" button.
    (Incorrect? Unclear? Broken link? Typo?)