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

# Update Status

> Update an existing status

Update the details of an existing status.

### Path Parameters

<ParamField path="id" type="integer" required>
  ID of the status to update
</ParamField>

### Body Parameters

<ParamField body="name" type="string" required>
  Name of the status
</ParamField>

<ParamField body="type" type="string" required enum={["CANDIDATE", "JOB", "JOB_SUBMISSION"]}>
  Type of entity this status applies to
</ParamField>

<ParamField body="description" type="string">
  Description of what this status means
</ParamField>

<ParamField body="isDefault" type="boolean">
  Whether this is the default status for new entities
</ParamField>

<ParamField body="isActive" type="boolean">
  Whether this status is active
</ParamField>

### Response

<ResponseField name="id" type="integer">
  The ID of the updated status
</ResponseField>

<ResponseField name="dateAdded" type="integer">
  Unix timestamp when the status was added
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request PUT \
    --url https://api.harmonyforstaffing.com/api/statuses/123 \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "name": "In Review",
      "type": "CANDIDATE",
      "description": "Updated description: Candidate is being reviewed",
      "isDefault": false,
      "isActive": true
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "id": 123,
    "name": "In Review",
    "type": "CANDIDATE",
    "description": "Updated description: Candidate is being reviewed",
    "isDefault": false,
    "isActive": true,
    "dateAdded": 1679253000
  }
  ```
</ResponseExample>