Errors
ConceptualError envelope, codes and correct client handling.
Errors use a stable envelope. Route on type and code, never on the human-readable message.
{
class="tok-str">"error": {
class="tok-str">"type": class="tok-str">"invalid_request",
class="tok-str">"code": class="tok-str">"capability_not_granted",
class="tok-str">"message": class="tok-str">"Capability 'codebase.write' is not granted to this API key.",
class="tok-str">"param": class="tok-str">"capabilities[class="tok-num">2]",
class="tok-str">"request_id": class="tok-str">"req_8k2ld9",
class="tok-str">"docs_url": class="tok-str">"https://docs.pimsy.ai/docs/tools/permissions"
}
}Last updated 2026-09-15

