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

# Overview

States represent the current status of a work item in your project workflow.

[Learn more about States →](https://docs.plane.so/core-concepts/work-items/states)

## The State object

**Attributes**

* `name` *string* **( required )**

  Name of the state

* `created_at` , `updated_at` *timestamp*

  Timestamp of the issue when it was created and when it was last updated

* `description` *string*

  Description of the state

* `color` *string* **(required)**

  String code of the color

* `workspace_slug` *string*

  Slugified name of the state auto generated from the system

* `sequence` *string*

  Auto generated sequence of the state for ordering.

* `group` *string* **(required)**

  Group to which the state belongs can only take values

  * backlog
  * unstarted
  * started
  * completed
  * cancelled

* `default` *boolean*

  Is it the default state in which if the issues are not assigned any states all the issues are created in this state.

* `created_by` & `updated_by`

  This values are auto saved and represent the id of the user that created or the updated the project.

* `project` *uuid*

  The project which the issue is part of auto generated from backend

* `workspace` *uuid*

  The workspace which the issue is part of auto generated from backend

<ResponseExample>
  ```json THE STATE OBJECT theme={null}
  {
  	"id": "f960d3c2-8524-4a41-b8eb-055ce4be2a7f",
  	"created_at": "2023-11-19T17:41:45.478363Z",
  	"updated_at": "2023-11-19T17:41:45.478383Z",
  	"name": "Ideation",
  	"description": "",
  	"color": "#eb5757",
  	"workspace_slug": "ideation",
  	"sequence": 130000.0,
  	"group": "unstarted",
  	"default": false,
  	"created_by": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  	"updated_by": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  	"project": "4af68566-94a4-4eb3-94aa-50dc9427067b",
  	"workspace": "cd4ab5a2-1a5f-4516-a6c6-8da1a9fa5be4"
  }
  ```
</ResponseExample>