EvoHub DocsEvoHub Docs Sign in

Set a list's review and done flags

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs.evohub.io/mcp

Claude Code

claude mcp add --transport http evohub-docs https://docs.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs": {
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs": {
      "type": "http",
      "url": "https://docs.evohub.io/mcp"
    }
  }
}
PUT/api/v1/board/lists/{listID}/flags

Marks the list as the board's review list, its done list, or neither. A list cannot be both. Cards that sit in a done list are archived after the board's auto_archive_days.

Changing which lists take part in review is how the board is run, so it needs board:board:write as well as the scope below; without it the answer is 403 FORBIDDEN.

Requires the board:review:write scope.

Authorization

Any one of:

Parameters

Path parameters

  • listID string required
    The list's ID.
    Example: lst_2b3c4d5e6f7a48b9c0d1e2f3a4b5c6d7

Request body required

Content type: application/json

Type: ListFlags

  • is_review_list boolean
    The board's review list.
  • is_done_list boolean
    The board's done list.

Responses

200

The list's flags.

Content type: application/json

Type: object

  • data object
    • flags ListFlags
      Show ListFlags properties
      • is_review_list boolean
        The board's review list.
      • is_done_list boolean
        The board's done list.

400

The body is not JSON for this endpoint (INVALID_BODY), or both flags are true (VALIDATION_ERROR).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

401

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

403

The key lacks board:review:write or board:board:write (FORBIDDEN).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

404

It does not exist, or it is on a board the caller cannot see (NOT_FOUND).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

429

Too many requests (RATE_LIMITED). Wait for Retry-After seconds.

Headers

  • Retry-After integer
    Seconds to wait before retrying.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

500

Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

Example request

curl -X PUT 'https://evohub.io/api/v1/board/lists/lst_2b3c4d5e6f7a48b9c0d1e2f3a4b5c6d7/flags' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
  "is_done_list": false,
  "is_review_list": true
}'