# List tags

Source: https://www.jawsdeploy.net/rest-api/tags-list | Section: Tags

List the tags defined in a workspace.

`GET /api/tag`

Tags are reusable labels applied to machines, cloud targets, project variable values, and steps for scope filtering.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `workspaceId` | query | string | yes | ID of the workspace. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `workspaceId`. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks the required role. |

Example request:

```
GET /api/tag?workspaceId=ws_abc
```

Example response:

```
{ "tags": [ { "tagId": "tag_1", "tagName": "us-east" } ] }
```