---
title: "Update Statuses"
method: PUT
path: "/incidents/v1/statuses"
tags: ["Investigations"]
---

# Update Statuses

`PUT /incidents/v1/statuses`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/incidents/v1/statuses`
- Auth: HTTP bearer

## Request body

- S12IncidentsV1UpdateStatusesRequest
  - `statuses` S12IncidentsV1UpdatableStatus[]: The set of statuses to set for the organisation
    - `status_id` string: required. the status ID to update
    - `badge_color` 'StatusBadgeColorAccent' | 'StatusBadgeColorInfo' | 'StatusBadgeColorNegative' | 'StatusBadgeColorPositive' | 'StatusBadgeColorWarning' | 'StatusBadgeColorSurface': - StatusBadgeColorAccent: Color is accent - StatusBadgeColorInfo: Color is info - StatusBadgeColorNegative: Color is negative - StatusBadgeColorPositive: Color is positive - StatusBadgeColorWarning: Color is warning - StatusBadgeColorSurface: Color is surface
    - `title_localised` S12IncidentsV1LocalisedStringSet
      - `strings` object: The map of BCP47 language codes to string content
      - `order` string[]: The ordered list of BCP47 language codes. 0th index acts as the default if no languages could be matched
  - `status_id_to_assign` string: The status ID to assign existing status references to

## Response `200`

A successful response.

- S12IncidentsV1UpdateStatusesResponse
  - `result` S12IncidentsV1StatusListItem[]: The updated statuses
    - `status_id` string: unique identifier for the status
    - `created_at` string, date-time: created timestamp for the status
    - `modified_at` string, date-time: last modified timestamp for the status
    - `title` string: Deprecated. use title_localised instead. title of the status
    - `badge_color` 'StatusBadgeColorAccent' | 'StatusBadgeColorInfo' | 'StatusBadgeColorNegative' | 'StatusBadgeColorPositive' | 'StatusBadgeColorWarning' | 'StatusBadgeColorSurface': - StatusBadgeColorAccent: Color is accent - StatusBadgeColorInfo: Color is info - StatusBadgeColorNegative: Color is negative - StatusBadgeColorPositive: Color is positive - StatusBadgeColorWarning: Color is warning - StatusBadgeColorSurface: Color is surface
    - `has_investigation_associated` boolean: Whether this investigations has any associated
    - `title_localised` S12IncidentsV1LocalisedString
      - `value` string: The string value that has been matched
      - `lang` string: The matched language which has been used to provided the value
      - `alternatives` S12IncidentsV1LocalisedStringSet
        - `strings` object: The map of BCP47 language codes to string content
        - `order` string[]: The ordered list of BCP47 language codes. 0th index acts as the default if no languages could be matched

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
