> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Job Tags V1

> Replace the tags on an existing job. Tag values follow the same rules as TriggerRequest.tags (≤20 entries × ≤64 chars, alphanumeric + _-:, deduped)…

Replace the tags on an existing job.

Tag values follow the same rules as `TriggerRequest.tags` (≤20
entries × ≤64 chars, alphanumeric + `_-:`, deduped). Pass `tags: []`
to clear them entirely. The rest of `params` is preserved.

### Path parameters

<ParamField path="job_id" type="string (uuid)" required />

### Request body

`UpdateJobTagsRequest`

<ParamField body="tags" type="string[]" required>
  Replacement tag list. Pass an empty array to clear tags. Same per-tag rules as `TriggerRequest.tags`.
</ParamField>

### Response

`JobTagsResponse`

<ResponseField name="job_id" type="string" required />

<ResponseField name="tags" type="string[]" required />

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `200` | Successful Response |
| `422` | Validation Error    |

<RequestExample>
  ```bash cURL theme={null}
  curl --request PATCH \
    --url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}/tags' \
    --header 'X-API-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "tags": [
      "priority"
    ]
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tags": [
      "priority"
    ]
  }
  ```
</ResponseExample>