Delete Tag from Task Definition
Endpoint: DELETE /api/metadata/task/{taskName}/tags
Removes a specific tag from a task definition based on the provided key-value pair.
Path Parameters
| Parameter | Description | Type | Required/ Optional |
|---|---|---|---|
| taskName | The name of the task definition from which the tag is to be removed. | string | Required. |
Request Body
| Parameter | Description | Type | Required/ Optional |
|---|---|---|---|
| key | The tag key. | string | Required. |
| value | The tag value. | string | Required. |
Response
- Returns 200 OK, indicating that the tag has been removed from the task definition.
- Returns 404 if the specified tag (key-value pair) does not exist for the task definition, or if the task definition itself does not exist.
Examples
Delete a tag from a task definition
Request
curl -X 'DELETE' \
'https://<YOUR-SERVER-URL>/api/metadata/task/hello_task/tags' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"key": "team",
"value": "engineering"
}'
Response
Returns 200 OK, indicating that the tag has been removed from the task definition.