Services API - POST tags

Assigns custom tags to the specified service. You need to provide only a tag value. The CONTEXTLESS context will be assigned automatically.

The request consumes an application/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/services/{meIdentifier}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/entity/services/{meIdentifier}

Parameters

Parameter Type Description In Required
meIdentifier string

The Dynatrace entity ID of the service you're inquiring.

path required
body UpdateEntity body optional

The UpdateEntity object

A list of tags to be assigned to a Dynatrace entity.

Element Type Description Required
tags string[]

A list of tags to be assigned to a Dynatrace entity.

required

Response format

A successful request doesn't return any content.

Example

In this example, the request assigns the PHP tag to the PHP-FPM via domain socket /run/php7-fpm.sock service, which has the ID of SERVICE-72503CBDD2AEF066.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066 \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \  
  -H 'Content-Type: application/json' \
  -d '{
  "tags": [
    "PHP"
  ]
}'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066

Request body

{
  "tags": [
    "PHP"
  ]
}

Response code

204