Skip to main content

Add Tags to an Environment Variable

Endpoint: PUT /api/environment/{name}/tags

Adds tags to an environment variable. You can add a single tag or multiple tags in one request. If a tag with the same key already exists, this operation will update its value.

Path parameters

ParameterDescriptionTypeRequired/ Optional
keyThe name of the environment variable to which the tags are to be added.stringRequired.

Request Body

The request body should be an array of tag objects.

ParameterDescriptionTypeRequired/ Optional
keyThe tag key.stringRequired.
valueThe tag value.stringRequired.

Example for adding multiple tags in a single request:

[
{
"key": "dev",
"value": "automation"
},
{
"key": "backend",
"value": "PR"
}
]

Response

Returns 200 OK, indicating that tags have been added to the environment variable.

Examples

Add a single tag to an environment variable

Request

curl -X 'PUT' \
'https://<YOUR-SERVER-URL>/api/environment/sampleKey/tags' \
-H 'accept: */*' \
-H 'X-Authorization: <HEADER>' \
-H 'Content-Type: application/json' \
-d '[
{
"key": "dev",
"value": "automation"
}
]
'

Response

Returns 200 OK, indicating that the tag has been added to the environment variable.

Add multiple tags to an environment variable

Request

curl -X 'PUT' \
'https://<YOUR-SERVER-URL>/api/environment/sampleKey/tags' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '[
{
"key": "dev",
"value": "automation"
},
{
"key": "backend",
"value": "PR"
}
]
'

Response

Returns 200 OK, indicating that tags have been added to the environment variable.