---
title: "Search the workspace's Files and pages"
method: GET
path: "/v1/workspaces/{workspaceId}/knowledge/search"
tags: ["Knowledge"]
---

# Search the workspace's Files and pages

`GET /v1/workspaces/{workspaceId}/knowledge/search`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/knowledge/search`
- Auth: HTTP bearer

Cited passages. 409 KNOWLEDGE_DISABLED when off; 501 when the instance has no search index.

## Query parameters

- `q` string, required
- `limit` integer
- `format` 'md'

## Response `200`

`{ query, ... }` results

## Other responses

- `400`: Invalid request
- `409`: Knowledge is off (KNOWLEDGE_DISABLED)

## Changes

- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/knowledge/search/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)