---
title: "Create a status group"
method: POST
path: "/assets/v1/status-groups"
tags: ["Assets"]
---

# Create a status group

`POST /assets/v1/status-groups`

Creates a status group with its initial status options.

## Request body

- S12AssetsV1CreateStatusGroupRequest — The parameters for `CreateStatusGroup`
  - `name` string — The name of the status group.
  - `description` string — The description of the status group.
  - `options` S12AssetsV1StatusOption[] — The initial status options for the 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.

## Response `200`

A successful response.

- S12AssetsV1CreateStatusGroupResponse — Result returned from `CreateStatusGroup`
  - `id` string — The identifier of the created status group.

## Other responses

- `default` — An unexpected error response.

---

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