# Unassign a tag from a machine

Source: https://www.jawsdeploy.net/rest-api/machines-tag-unassign | Section: Machines

Remove one tag from a machine, leaving its other tags alone.

`DELETE /api/machine/tag`

Removes one tag from the machine. The machine's other tags are left untouched.

Removing a tag the machine does not have is **not an error**, so a pipeline can unassign without checking first.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `machineId` | query | string | yes | ID of the machine, from [List machines](https://www.jawsdeploy.net/rest-api/machines-list). |
| `tagId` | query | string | yes | ID of the tag to remove. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `machineId`. A machine that belongs to another organization is reported the same way as one that does not exist. |
| 400 | Missing `tagId`. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks permission to manage machines in this workspace. |

Example request:

```
DELETE /api/machine/tag?machineId=mch_web01&tagId=tag_canary
```

Example response:

```
{}
```