# Search the docs

### Search the docs

`POST /api/v1/docs/search`

Operation ID: `searchDocs`

Finds Needle documentation pages: guides, concepts, every endpoint, and every MCP tool. Pages that match more of the words come first. Pass a pageId to Get a docs page to read it.

**Request body** (required)

- `query` (string, required): Words to look for. Pages that match more of them come first.
- `limit` (integer, optional): Most pages to return. Default 10.

**200**: Matching docs pages, best match first.

- `results` (object[], required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload