Updating roles

A user with admin role can update an existing role.

Procedure

  1. In a REST client platform, add the authentication details of the tenant where you want to update an existing role.
    
    //In case of Instance API key 
    Headers:
    {
    "x-instance-api-key": "instance_api_key"
    }
     
    // In case of MCSP or ISV token
    Headers:
    {
    "Authorization": "mcsp_or_isv_token"
    }
    
    Body: 
    	{
    	"name": "<role_name>*^",
    	"description": "<role_description>",
    	"projects": 
    	[{
    	"<project_name>": ["r", "w", "e"]  
    	}]
    }
    
    // A field with the asterisk (*) character in the body of the request is a required field. 
    // A field with the caret (^) character in the body of the request indicates that the field can only have unique values.
  2. Make a PUT request at the URL of the project.

    URL syntax - <domain>/apis/v1/rest/roles/:role_uid

    In this URL request, /:role_uid is the ID of the role you want to update.

    Method. PUT

    If the request is successful, you receive the response code for success.

    {
    output : 
    {
    	"name": <role_name>,
    	"uid": <role_uid>,
    	"tenant_uid": <project_tenant_uid>,
    	"permissions": 
    		[
    			{
    			"project_uid": "<project_uid>",
    			"access_list": 
    			{
    			"read": true,
    			"write": true,
    			"execute":true                  
    			}
    			}
    		],
    "created_at": "<role_created_at>",
    "updated_at": "<role_updated_at>",
    }
    }