| method | path | purpose |
|---|---|---|
PUT | /v1/auth/keys/{key_id}/briefing | Set the key's standing instructions (≤8000 chars). Readable + editable — GET/DELETE on the same path. |
POST | /v1/knowledge-sets | Create a knowledge set (account-level; keys attach). |
GET | /v1/knowledge-sets · GET /{id} | List / inspect (documents, attached keys, quota use). |
POST | /v1/knowledge-sets/{id}/documents | Add a text document ({name, text}, ≤256 KB). No files — text only. |
DELETE | /v1/knowledge-sets/{id}/documents/{doc_id} | Remove one document (and its index entries). |
POST | /v1/knowledge-sets/{id}/attach · /detach | {key_id} — compose each key's reading list. |
GET | /v1/knowledge-sets/{id}/search?q= | Query a set directly (what retrieval will see). |
DELETE | /v1/knowledge-sets/{id} | Delete the set and everything in it. |
Quotas: 256 KB/document, 2 MB/set, 20 MB uploaded per account per month. Exceeding any
returns 413 with a named error — never a silent truncation.