EvoHub DocsEvoHub Docs Sign in

Rename or move 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/retro/boards/{boardID}

Changes a board's name and description, and optionally its team and visibility. Works on a closed board too.

  • name is required on every call, at most 200 characters.
  • description is replaced by what you send; leaving it out clears it.
  • team_id: left out, the board stays where it is; "" moves it to the whole organization; a team must be one the caller is in.
  • visibility: left out, it is kept. A team board needs a team.

Requires the retro:board:write scope.

Authorization

Any one of:

Parameters

Path parameters

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

Request body required

Content type: application/json

Type: UpdateBoardRequest

  • name string required
    Max length: 200
  • description string
    Replaces the description; left out, it is cleared.
  • team_id string
    Left out keeps the board's team; "" moves it to the whole organization.
  • visibility Visibility
    One of: org team private

Responses

200

The board was changed.

Content type: application/json

Type: IdEnvelope

  • success boolean
  • data object
    • id string

400

The body is not JSON (INVALID_BODY), name is missing or blank (MISSING_NAME), name is over 200 characters (VALIDATION_FAILED), visibility is unknown (INVALID_VISIBILITY), or a team board would have no team (TEAM_REQUIRED).

Content type: application/json

Type: Error | ValidationFailed

One of:

  • Error
    Show Error properties
    • success boolean
      Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
      Value: false
    • error object required
      • code string required
        Example: NOT_FOUND
      • message string required
        Example: board not found
      • request_id string
  • ValidationFailed
    Show ValidationFailed properties
    • success boolean
      Value: false
    • error object required
      • code string required
        Value: VALIDATION_FAILED
      • message string required
      • details array of object required
        • field string
        • message string
      • request_id string

401

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

Content type: application/json

Type: Error

  • success boolean
    Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
    Value: false
  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: board not found
    • request_id string

403

The key lacks retro:board:write (FORBIDDEN), or team_id names a team the caller is not in (NOT_IN_TEAM).

Content type: application/json

Type: Error

  • success boolean
    Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
    Value: false
  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: board not found
    • request_id string

404

The board does not exist, or the caller cannot see it (NOT_FOUND).

Content type: application/json

Type: Error

  • success boolean
    Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
    Value: false
  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: board 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

  • success boolean
    Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
    Value: false
  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: board not found
    • request_id string

500

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

Content type: application/json

Type: Error

  • success boolean
    Sent by Retro itself; refusals before the request reaches Retro (401, 429) carry only error.
    Value: false
  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: board not found
    • request_id string

Example request

curl -X PATCH 'https://evohub.io/api/v1/retro/boards/brd_3f9a1c7e2b8d4a60' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
  "name": "Sprint 42 retrospective",
  "description": "What went well and what to change after sprint 42"
}'