---
title: "Update an existing Job Sub Status"
method: PUT
path: "/v2/jobSubStatus/{id}"
tags: ["Job Sub Status"]
---

# Update an existing Job Sub Status

`PUT /v2/jobSubStatus/{id}`

Updates an existing Job Sub Status and returns the updated Job Sub Status.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateJobSubStatusV2Dto
  - `name` string — The name of the job sub status.
  - `color` 'silver' | 'blue' | 'green' | 'orange' | 'red' | 'anthracite' | 'grey' | 'azure' | 'denim' | 'royalBlue' | 'crimson' | 'cerise' | 'apricot' | 'cream' | 'bronze' | 'yellow' | 'emerald' | 'forest' | 'purple' | 'plum' | 'lavender' | 'violet' | 'slate' — The color key for the job sub status. Available colors:<br>silver: #cccccc<br>blue: #004795<br>green: #6d960c<br>orange: #cc9707<br>red: #e35a36<br>anthracite: #282e36<br>grey: #666666<br>azure: #3589E9<br>denim: #24589B<br>royalBlue: #000ED2<br>crimson: #B91C1C<br>cerise: #E11D48<br>apricot: #FBAB33<br>cream: #E8CF63<br>bronze: #D58E41<br>yellow: #FFD400<br>emerald: #22C55E<br>forest: #3E802B<br>purple: #9747FF<br>plum: #B25494<br>lavender: #D574E4<br>violet: #391E86<br>slate: #3B4B52

## Response `200`

The updated Job Sub Status.

- ResponseJobSubStatusV2Dto
  - `id` string — The ID of the job sub status (prefix `JSS-`).
  - `name` string — The name of the job sub status.
  - `parentName` string — The name of the parent job status.
  - `color` 'silver' | 'blue' | 'green' | 'orange' | 'red' | 'anthracite' | 'grey' | 'azure' | 'denim' | 'royalBlue' | 'crimson' | 'cerise' | 'apricot' | 'cream' | 'bronze' | 'yellow' | 'emerald' | 'forest' | 'purple' | 'plum' | 'lavender' | 'violet' | 'slate' — The color key of the job sub status.

## Other responses

- `400` — Invalid input.
- `401` — Missing or invalid authentication token.
- `404` — Job Sub Status not found.

---

[API](https://skmtc.net/workiz/apis/developer-api.md) · [All operations](https://skmtc.net/workiz/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workiz/developer-api/revisions/14666f4db0f8/schema)