# labels

Query

List the creator labels of the current workspace, alphabetically by name (case-insensitive). `deleting` is true while a workspace-wide deletion of the label is in progress; do not assign such a label, and do not recreate it until it disappears from this list. Returns at most 1000 rows; this field is not paginated.

Available to agents as MCP tool `getLabels` — see [Read tools](/api/v2/docs/mcp/read-tools#get-labels).

## Arguments

This field takes no arguments.

## Returns

Returns [`[Label!]!`](/api/v2/docs/types/label).

## Examples

### List labels

Return every creator label in the workspace, by name, with its deleting flag.

```graphql
query LabelsDefault {
  labels {
    name
    deleting
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "labels": [
      {
        "name": "Gifting",
        "deleting": false
      },
      {
        "name": "Plant Parents",
        "deleting": false
      },
      {
        "name": "Retired 2024",
        "deleting": false
      },
      {
        "name": "VIP",
        "deleting": false
      }
    ]
  }
}
```