# Update Workflow Tag

Rename a tag or change its color. Workflows keep it.

`PUT https://connect.mindcloud.co/v2/workflow-tags/:tagId`

Permissions: `workflow:edit`.

## Parameters

### Path

- `tagId` (string, required): The tag's id, from List Workflow Tags.

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

### Body

- `name` (string): A new name.
  A new name, at most 24 characters.
- `color` (string): A palette color name.
  A new palette color: green, purple, pink, orange, yellow, blue, red or gray.
  Allowed values:
    - `green`
    - `purple`
    - `pink`
    - `orange`
    - `yellow`
    - `blue`
    - `red`
    - `gray`

## Example request

```bash
curl --request PUT \
  --url 'https://connect.mindcloud.co/v2/workflow-tags/Tg2mV7xQ4kNs' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Shopify",
  "color": "blue"
}'
```

## Response fields

- `id` (string): The tag's id. Put it in a workflow's tags.
- `name` (string): The tag's name, at most 24 characters.
- `color` (string): The tag's color, a name from the editor's palette: green, purple, pink, orange, yellow, blue, red or gray.
- `createdOn` (date): When the tag was created.
- `updatedOn` (date): When the tag was last changed.
