---
title: Create
url: https://www.tines.com/docs/api/cases/case_statuses/create/
updated: 2026-06-15T08:41:58+00:00
description: Create a case status for a team.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Tines API](https://www.tines.com/llms.txt) › [Cases](https://www.tines.com/llm/docs/api/cases.md) › [Case statuses](https://www.tines.com/llm/docs/api/cases/case_statuses.md)*

# Create

*[View on tines.com](https://www.tines.com/docs/api/cases/case_statuses/create/)*

## Description

Create a case status for a team.

## Request

HTTP Method: **POST**

| Body Parameter | Description                                                                                   |
| -------------- | --------------------------------------------------------------------------------------------- |
| team_id        | ID of the team the status belongs to.                                                         |
| name           | Case status name.                                                                             |
| parent_status  | **Optional** The parent status the status sits under: `OPEN` or `CLOSED`. Defaults to `OPEN`. |
| description    | **Optional** A description for the status.                                                    |

### Sample request

```bash
curl -X POST \
  https://<tenant-domain>/api/v1/case_sub_statuses \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
        "team_id": 1,
        "name": "Triage",
        "parent_status": "OPEN",
        "description": "Newly opened cases awaiting review."
      }'
```

## Response

A successful request will return a JSON object describing the created case status.

### Field description

| Parameter     | Description                                                               |
| ------------- | ------------------------------------------------------------------------- |
| id            | Case status ID.                                                           |
| name          | Case status name.                                                         |
| slug          | A human-readable identifier for the status, auto-generated from the name. |
| description   | Case status description, or `null` if none is set.                        |
| parent_status | The parent status the status belongs to: `OPEN` or `CLOSED`.              |
| default       | Whether this is the default status for its parent status.                 |
| team          | An object containing the `id` of the team the status belongs to.          |
| created_at    | ISO 8601 timestamp describing when the status was created.                |
| updated_at    | ISO 8601 timestamp describing when the status was last updated.           |

### Sample response

<!-- cspell:disable -->

```json
{
  "id": 41,
  "name": "Triage",
  "slug": "triage",
  "description": "Newly opened cases awaiting review.",
  "parent_status": "OPEN",
  "default": false,
  "team": {
    "id": 1
  },
  "created_at": "2026-04-10T09:15:42.128Z",
  "updated_at": "2026-04-10T09:15:42.128Z"
}
```

<!-- cspell:enable -->