List Boards

Overview

Boards are the top-level containers for organizing work in StrikeOff. Each board belongs to an organization and contains multiple lists (columns), which in turn contain tasks. Think of a board as a project or a department's workspace. This endpoint returns every board your API key has access to within your organization, giving you a complete view of all available workspaces. Use this as your starting point when integrating with StrikeOff - first fetch boards to understand how work is organized, then drill down into specific boards to find lists and create tasks.

When to Use This

• Discovering available boards when setting up your integration for the first time
• Building a dropdown or selector in your app that lets users choose which StrikeOff board to sync with
• Auditing or reporting on all boards in an organization
• Finding the right board ID before fetching its lists or members
• Displaying a dashboard that shows task counts across all boards

Request Example

curl -X GET "https://strikeoffapp.com/api/external/v1/boards" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "boards": [
      {
        "id": "clxxx123...",
        "name": "Development",
        "description": "Engineering tasks and projects",
        "createdAt": "2024-01-15T10:00:00Z",
        "updatedAt": "2024-01-15T10:00:00Z",
        "listCount": 5,
        "memberCount": 12
      },
      {
        "id": "clyyy456...",
        "name": "Marketing",
        "description": "Marketing campaigns and content",
        "createdAt": "2024-02-01T09:00:00Z",
        "updatedAt": "2024-02-01T09:00:00Z",
        "listCount": 3,
        "memberCount": 8
      }
    ]
  }
}

Notes

• Returns only boards that belong to the organization associated with your API key.
• Board counts (listCount, memberCount) are computed at query time.
• Results are not paginated in v1.