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

# status.updated

> Occurs when a pipeline status is updated

<ResponseExample>
  ```json Example payload theme={null}
  {
    "id": "ck9v2m5nj0xp4wq7ybftrae8",
    "seq": 189,
    "teamId": "hzcai5t59nn9vsck3rbuepyg",
    "type": "status.updated",
    "timestamp": "2025-01-15T17:10:00.000Z",
    "version": "1.0",
    "data": {
      "status": {
        "id": "n5xr8yk0wr6q3cwohgeufqmz",
        "name": "Qualified Lead",
        "color": "#3b82f6",
        "createdAt": "2025-01-02T09:00:00.000Z"
      }
    }
  }
  ```
</ResponseExample>

## When it fires

* A pipeline status is renamed through the Inbox UI
* A status color is changed
* Any status property is modified

The `status` object reflects the state **after** the update.

## Payload

<ResponseField name="status" type="Status" required>
  The status object.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique identifier for the status.
    </ResponseField>

    <ResponseField name="name" type="string">
      The display name of the status (e.g., "New Lead", "Qualified", "Closed Won").
    </ResponseField>

    <ResponseField name="color" type="string | null">
      Hex color code for the status (e.g., `#10b981`). Null if no color is set.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of when the status was created.
    </ResponseField>
  </Expandable>
</ResponseField>