Skip to content

Get States

GET /api/v1/states

This route is used to retrieve all cards associated with the authenticated user. Each card will include its associated tags.

Request

Authentication

🔒 Authentication is required. A valid minban_token cookie must be present to authorize the request.

Headers

No special headers required.

Body

No body is required.

Responses

200 OK

The request was successful, and a list of states associated with the authenticated user is returned. Each state includes its details.

Example response:

[
  {
    "id": 1,
    "name": "Todo",
    "position": 1,
    "color": "FF0000"
  },
  {
    "id": 2,
    "name": "In Progress",
    "position": 2,
    "color": "00FF00"
  },
  {
    "id": 3,
    "name": "Done",
    "position": 3,
    "color": "0000FF"
  }
]

401 Unauthorized

The user is not authenticated, or the minban_token cookie is missing or invalid.

Example response:

{
  "error": "Unauthorized"
}

500 Internal Server Error

An unexpected error occurred while querying the database.

Example response:

{
  "error": "Failed to retrieve states"
}