---
title: "Update a status group"
method: PATCH
path: "/assets/v1/status-groups/{status_group.id}"
tags: ["Assets"]
---

# Update a status group

`PATCH /assets/v1/status-groups/{status_group.id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/assets/v1/status-groups/{status_group.id}`
- Auth: HTTP bearer

Updates a status group's name, description, and status options. Removing an option reassigns or clears the assets currently using it.

## Path parameters

- `status_group.id` string, required

## Request body

- S12AssetsV1StatusGroupsServiceUpdateStatusGroupBody: The parameters for `UpdateStatusGroup`
  - `status_group` object: The status group to update.
    - `name` string: The name of the status group.
    - `description` string: The description of the status group.
    - `options` S12AssetsV1StatusOption[]: The status options belonging to this group, ordered by position ascending. Maximum 10 options per group.
      - `id` string: The identifier of the status option.
      - `name` string: The name of the status option.
      - `color` 'STATUS_BADGE_COLOR_ACCENT' | 'STATUS_BADGE_COLOR_INFO' | 'STATUS_BADGE_COLOR_NEGATIVE' | 'STATUS_BADGE_COLOR_POSITIVE' | 'STATUS_BADGE_COLOR_WARNING' | 'STATUS_BADGE_COLOR_SURFACE': StatusBadgeColor defines the semantic color palette for status badges. - STATUS_BADGE_COLOR_ACCENT: Color is accent - STATUS_BADGE_COLOR_INFO: Color is info - STATUS_BADGE_COLOR_NEGATIVE: Color is negative - STATUS_BADGE_COLOR_POSITIVE: Color is positive - STATUS_BADGE_COLOR_WARNING: Color is warning - STATUS_BADGE_COLOR_SURFACE: Color is surface
      - `position` integer: The display position of the status option within the group.
      - `created_at` string, date-time: Time when the status option was created.
      - `modified_at` string, date-time: Time when the status option was last modified.
    - `created_at` string, date-time: Time when the status group was created.
    - `modified_at` string, date-time: Time when the status group was last modified.
    - `types` S12AssetsV1Type[]: The asset types assigned to this status group.
      - `id` string: The global unique identifier of the type.
      - `name` string: Name of the type.
      - `type` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_PREDEFINED' | 'TYPE_CATEGORY_CUSTOM': Category of Type. - TYPE_CATEGORY_UNSPECIFIED: Type Category Unspecified. - TYPE_CATEGORY_PREDEFINED: Predefined Type defined by system. - TYPE_CATEGORY_CUSTOM: Custom type defined by organisation.
  - `update_mask` string, required: REQUIRED. The fields to update.
  - `reassign_to_option_id` string: The identifier of the status option to reassign assets to when options are removed. If omitted, assets assigned to removed options are cleared.

## Response `200`

A successful response.

- S12AssetsV1UpdateStatusGroupResponse: Result returned from `UpdateStatusGroup`
  - `status_group` S12AssetsV1StatusGroup: A status group defines a set of status options that can be assigned to an asset type.
    - `id` string: The identifier of the status group.
    - `name` string: The name of the status group.
    - `description` string: The description of the status group.
    - `options` S12AssetsV1StatusOption[]: The status options belonging to this group, ordered by position ascending. Maximum 10 options per group.
      - `id` string: The identifier of the status option.
      - `name` string: The name of the status option.
      - `color` 'STATUS_BADGE_COLOR_ACCENT' | 'STATUS_BADGE_COLOR_INFO' | 'STATUS_BADGE_COLOR_NEGATIVE' | 'STATUS_BADGE_COLOR_POSITIVE' | 'STATUS_BADGE_COLOR_WARNING' | 'STATUS_BADGE_COLOR_SURFACE': StatusBadgeColor defines the semantic color palette for status badges. - STATUS_BADGE_COLOR_ACCENT: Color is accent - STATUS_BADGE_COLOR_INFO: Color is info - STATUS_BADGE_COLOR_NEGATIVE: Color is negative - STATUS_BADGE_COLOR_POSITIVE: Color is positive - STATUS_BADGE_COLOR_WARNING: Color is warning - STATUS_BADGE_COLOR_SURFACE: Color is surface
      - `position` integer: The display position of the status option within the group.
      - `created_at` string, date-time: Time when the status option was created.
      - `modified_at` string, date-time: Time when the status option was last modified.
    - `created_at` string, date-time: Time when the status group was created.
    - `modified_at` string, date-time: Time when the status group was last modified.
    - `types` S12AssetsV1Type[]: The asset types assigned to this status group.
      - `id` string: The global unique identifier of the type.
      - `name` string: Name of the type.
      - `type` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_PREDEFINED' | 'TYPE_CATEGORY_CUSTOM': Category of Type. - TYPE_CATEGORY_UNSPECIFIED: Type Category Unspecified. - TYPE_CATEGORY_PREDEFINED: Predefined Type defined by system. - TYPE_CATEGORY_CUSTOM: Custom type defined by organisation.

## 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)
