Box HTTP API v1

Base URL: https://ascii.dev/api/box/v1 — auth is Authorization: Bearer $BOX_API_KEY on every request (create keys in the Box dashboard, API Keys tab). For typed clients prefer the SDKs (box-sdk-typescript / box-sdk-python skills); for shell integration the CLI (box-cli skill).

Response envelope & errors

Every v1 JSON body has ok (boolean) and type (stable discriminator, e.g. box.list, prompt.queued). Errors keep HTTP status authoritative and add a structured envelope:

{"ok": false, "type": "box.error", "status": 409, "code": "provider_not_configured", "message": "...", "error": {"code": "...", "message": "...", "status": 409, "details": {}}, "requestId": "req_..."}