Overview

POST   /api/v1/workspaces/:workspace-slug/projects/:project_id/states/
GET    /api/v1/workspaces/:workspace-slug/projects/:project_id/states/
GET    /api/v1/workspaces/:workspace-slug/projects/:project_id/states/:state_id/
PATCH  /api/v1/workspaces/:workspace-slug/projects/:project_id/states/:state_id/
DELETE /api/v1/workspaces/:workspace-slug/projects/:project_id/states/:state_id/

​

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

{
	"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"
}