You can assign tags to an object by using the Orchestrator REST API.

About this task

You can create both private and global tags. You specify whether the tag is private or global in the body of the request.


To create global tags, you must be logged in as a user with administrative privileges.

You can also assign a value to the tag that you create. The value is an optional parameter that you can use to filter tags.


  1. Define the request body by using the following syntax.
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <tag-instance xmlns="" global="false">

    You can create a global tag by setting the global variable to "true".

  2. Make a POST request at the URL of the object:
    POST http://{vcoHost}:{port}/vco/api/catalog/{namespace}/{objectType}/{objectId}/tags


If the POST request is successful, you receive the status code 200.