EvoHub DocsEvoHub Docs Sign in

Edit a card's title or description

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/cards/{cardID}

Changes the card's title, description or both; a field left out is not changed, and at least one must be sent. Every edit raises the card's version by one. Send the version you last read to refuse the edit if someone changed the card since (409 EDIT_CONFLICT); leave it out to apply the edit regardless.

Requires the board:card:write scope.

Authorization

Any one of:

Parameters

Path parameters

  • cardID string required
    The card's ID.
    Example: crd_9f2e4d6c8b0a1e3f5d7c9b1a3e5f7d90

Request body required

Content type: application/json

Type: object

  • title string
    Max length: 200
  • description string
    Max length: 20000
  • version integer
    The version this edit was made against.

Responses

200

The card after the edit.

Content type: application/json

Type: CardEnvelope

  • data object
    • card Card
      Show Card properties
      • id string
        Example: crd_9f2e4d6c8b0a1e3f5d7c9b1a3e5f7d90
      • board_id string
      • list_id string
      • number integer
        The card's number on its board, from 1. With the board's card_prefix it is the card's reference.
      • title string
        Max length: 200
      • description string
        Max length: 20000
      • color string
        A hex colour, or "" for none.
      • due_at string (date-time)
        Absent when the card has no due date.
      • review Review
        Show Review properties
        • state string
          One of: pending approved
        • approved_by string
        • approved_at string (date-time)
      • completed_at string (date-time)
        When the card entered a done list. Absent while it is not in one.
      • created_by string
      • created_at string (date-time)
      • updated_at string (date-time)
      • version integer
        Goes up by one on every edit of the title or description.
      • assignee_ids array of string | null
        Who the card is on. Filled in when a board or list is read; null when one card is read on its own.
      • label_ids array of string | null
        The labels the card carries. Filled in when a board or list is read; null when one card is read on its own.

400

The body is not JSON for this endpoint (INVALID_BODY), or (VALIDATION_ERROR) neither field was sent, the title is blank or over 200 characters, or the description is over 20,000.

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 the scope this endpoint needs (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

409

The card changed since version (EDIT_CONFLICT). Read it again and reapply the edit.

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/cards/crd_9f2e4d6c8b0a1e3f5d7c9b1a3e5f7d90' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
  "version": 3,
  "description": "Rotate before the old ones expire on the 30th. Staging first."
}'