EvoHub DocsEvoHub Docs Sign in

List my open action items

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

GET/api/v1/retro/action-items/mine

The open action items owned by the caller on the boards they can see: overdue first, then by due date (no due date last), then oldest. open and overdue count every matching item, not only the ones returned.

An item is the caller's when its assignee_user_id is the caller's user ID. With a personal key that is the key's person; an organization key owns no items, so it gets an empty list.

Requires the retro:action:read scope.

Authorization

Any one of:

Parameters

Query parameters

  • limit integer
    How many items to return. Values above 50 are read as 50.
    Default: 10 · Minimum: 1 · Maximum: 50
  • team_id string
    Narrow to one team's boards plus the organization-wide ones, or none for only the organization-wide ones. It never widens what the caller can see.
    Example: none

Responses

200

The caller's open action items and their counts.

Content type: application/json

Type: object

  • success boolean
  • data MyActionItems
    Show MyActionItems properties
    • items array of object
      • id string
      • board_id string
      • board_name string
      • description string
      • status string
        Value: open
      • due_at string (date-time) | null
      • created_at string (date-time)
    • open integer
      All of the caller's open items.
    • overdue integer
      Those of them past their due date.

400

limit is not a positive integer (INVALID_LIMIT).

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

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

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 GET 'https://evohub.io/api/v1/retro/action-items/mine' \
  -H 'Authorization: Bearer <TOKEN>'