Skip to main content
DELETE
/
boxes
/
{boxId}
Delete box
curl --request DELETE \
  --url https://ascii.dev/api/box/v1/boxes/{boxId} \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "type": "box.deleted",
  "id": "bx_23456789",
  "status": "deleted"
}

Authorizations

Authorization
string
header
required

Box API key in the form box_.... Create and rotate keys in the Box dashboard or through the v1 API key endpoints.

Path Parameters

boxId
string
required

Public Box id returned by create/list/get box calls.

Pattern: ^bx_[23456789abcdefghjkmnpqrstuvwxyz]{8}$

Response

Box deleted.

ok
boolean
required
Example:

true

type
string
required

Stable success envelope discriminator added by v1.

Allowed value: "box.deleted"
id
string
required
status
string
required
Allowed value: "deleted"