---
title: "Search boards and cards in a workspace"
method: GET
path: "/workspaces/{workspacePublicId}/search"
tags: ["Workspaces"]
---

# Search boards and cards in a workspace

`GET /workspaces/{workspacePublicId}/search`

Searches for boards and cards by title within a workspace

## Path parameters

- `workspacePublicId` string, required

## Query parameters

- `query` string, required
- `limit` number

## Response `200`

Successful response

- union[]
  - union
    - object
      - `publicId` string, required
      - `title` string, required
      - `description` string, nullable, required
      - `slug` string, required
      - `updatedAt` string, nullable, required
      - `createdAt` string, required
      - `type` 'board', required
    - object
      - `publicId` string, required
      - `title` string, required
      - `description` string, nullable, required
      - `boardPublicId` string, required
      - `boardName` string, required
      - `listName` string, required
      - `cardNumber` number, nullable, required
      - `updatedAt` string, nullable, required
      - `createdAt` string, required
      - `type` 'card', required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/kan/apis/kan-api.md) · [All operations](https://skmtc.net/kan/apis/kan-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kan/kan-api/versions/3235f0c88e7a/schema)