You can set the permissions for a configuration element by using the Orchestrator REST API.


Review the types of permissions that you can set and the syntax that you can use in the request body. See REST API Permissions.


  1. Make a GET request and retrieve the ID of the configuration element from the list of returned configuration elements:
    GET http://{orchestrator_host}:{port}/vco/api/configurations/
  2. In a REST client application, add request headers to define the properties of the configuration element for which you want to set permissions.
  3. In the request body, specify the permissions that you want to set.
  4. Make a POST request at the URL of the configuration element's permissions:
    POST http://{orchestrator_host}:{port}/vco/api/configurations/{configuration_elementID}/permissions/


If the POST request is successful, you receive the status code 201. Information about the configuration element's permissions is available in the response body.