EvoHub DocsEvoHub Docs Sign in

Update a board

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

Add to CursorAdd to VS Code

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

llms.txtllms-full.txt

PATCH/api/v1/board/boards/{boardID}

Changes a board's name, description, visibility, team and auto-archive setting.

Send name and description every time: name is required, and a missing description is saved as empty. Leave out visibility to keep it, and with it the board's team. When you send visibility: team, send the team_id too; moving a board into a team needs the caller to be in that team.

auto_archive_days (1–365) is how long a card may sit in the done list before it is archived; left out, it is not changed. template and card_prefix are ignored here.

Requires the board:board:write scope.

Authorization

Any one of:

Parameters

Path parameters

  • boardID string required
    The board's ID.
    Example: brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59

Request body required

Content type: application/json

Type: UpdateBoardRequest

  • name string required
    Max length: 120
  • description string
    Saved as empty when left out.
    Max length: 500
  • visibility Visibility
    One of: private team org
  • team_id string
  • auto_archive_days integer
    Minimum: 1 · Maximum: 365
  • template string
    Ignored.
  • card_prefix string
    Ignored; a board's prefix never changes.

Responses

200

The board after the change.

Content type: application/json

Type: BoardEnvelope

  • data object
    • board Board
      Show Board properties
      • id string
        Example: brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59
      • name string
        Max length: 120
      • description string
        Max length: 500
      • visibility Visibility
        One of: private team org
      • team_id string
        The team a team board belongs to; "" for every other board.
      • card_prefix string
        The front of every card reference on the board, as in PLT-42. Never changes.
        Example: PLT
      • created_by string
      • created_at string (date-time)
      • updated_at string (date-time)
      • auto_archive_days integer
        Days a card may sit in the done list before it is archived. 0 in the board list.
        Minimum: 1 · Maximum: 365

400

The body is not JSON for this endpoint (INVALID_BODY), or a field breaks a rule (VALIDATION_ERROR): the name, description, visibility and team rules of creating a board, or auto_archive_days outside 1–365.

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:board:write, or the board is being moved into a team the caller is not in (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 PATCH 'https://evohub.io/api/v1/board/boards/brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
  "name": "Platform",
  "team_id": "team_8b2c4d6e-1f3a-4b5c-9d7e-0a1b2c3d4e5f",
  "visibility": "team",
  "description": "Infrastructure and platform work.",
  "auto_archive_days": 90
}'