Send Docs Feedback

SmartDocs basics

1. In the Resource URL, replace any values enclosed in "{}", such as your organization name.
2. Set the Basic Authentication credentials. These are your Edge email and password (user must be in the Org Admin role).
3. Tweak the Request Body as needed (if a body is needed).
4. Send the live request to Edge and view the response! You can also view Request data.

Add Permissions for Resource to a Role

Resource Summary

Auth Type


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
  • Content-Type
    Specify the content type

Request Body

org_name Mention the organization name true

role_name Mention the role name true

Basic Auth

OAuth 2

Custom Token


Make a request and see the response.

Make a request and see the response.


Help or comments?