knowledge_pack_over_budget
The upload compiles inside the hard cap but over the budget_tokens ceiling the caller asked for. Raise the budget (up to the cap) or distill the sources; errors[] reports each document's token cost.
Problem shape
Every non-2xx response is an RFC 9457 application/problem+json body. The type URI below is stable and machine-matchable, so branch on the final path segment (the code) and treat the status as redundant confirmation. See the error-handling guide.
{
"type": "https://docs.vocapable.com/errors/knowledge_pack_over_budget",
"title": "…",
"status": 409,
"detail": "…",
"instance": "/v1/…"
}