---
title: "Switch a document on or off, rename it, attach it to every answer."
method: PATCH
path: "/api/projects/{id}/knowledge/{kbId}"
tags: ["Knowledge"]
---

# Switch a document on or off, rename it, attach it to every answer.

`PATCH /api/projects/{id}/knowledge/{kbId}`

## Request

- Base URL: `https://dosai.pro`
- URL: `https://dosai.pro/api/projects/{id}/knowledge/{kbId}`
- Auth: HTTP bearer

## Request body

- object

## Response `200`

Switch a document on or off, rename it, attach it to every answer.

- CabinetObject: The object exactly as the cabinet screen receives it. Field-by-field notes live in the guide article; the MCP tools at /api/mcp project it for AI agents.

## Other responses

- `401`: Missing, invalid, expired or revoked key.
- `403`: Not allowed. Distinguish by `code`: `INSUFFICIENT_SCOPE` (read-only key attempted a mutation), `API_KEY_PROJECT_SCOPE` (project-scoped key reached outside its project), `FORBIDDEN` (the user's role on this project is too low), `ACCOUNT_BANNED`.
- `404`: No such resource, or it belongs to another account.
- `429`: Too many requests. 120/min per key overall, plus a stricter per-endpoint budget. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/dosai/apis/dos-ai-public-api.md) · [All operations](https://skmtc.dev/dosai/apis/dos-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dosai/apis/dos-ai-public-api/revisions/38ce5f4e8f50?raw)
