---
title: "getKanbanBoards"
method: GET
path: "/v1/kanban/boards"
tags: ["Kanban"]
---

# getKanbanBoards

`GET /v1/kanban/boards`

Returns a list of all Kanban boards accessible to the authenticated user.

Use the `filter` query parameter to narrow results to boards the user owns (`owned`) or boards shared with them (`shared`). When omitted, all accessible boards are returned.

## Query parameters

- `filter` 'owned' | 'shared'

## Response `200`

Successfully retrieved boards

- BoardSummary[]
  - `id` string
  - `title` string
  - `description` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string
  - `org_id` string
  - `updated_by` string
  - `shared_with` string[]
  - `shared_with_org` boolean
  - `owners` string[] — Array of user IDs who have full ownership rights for this board (view, edit, delete)

## Other responses

- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.dev/epilot/apis/kanban-api.md) · [All operations](https://skmtc.dev/epilot/apis/kanban-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/kanban-api/revisions/051153ffb2ea/schema)
