Skip to main content
POST
Delete a board

Authorizations

Authorization
string
header
required

A human (abh_…), agent (aba_…), browser (abb_…) or machine delegation (abd_…) token. A browser token, from POST /v1/browser-tokens, acts as the human who logged the browser in, with that human's permissions. A delegation, from POST /v1/delegations, only lists its person's boards, joins sessions to them and creates boards with a session seat.

Headers

Idempotency-Key
string
Required string length: 1 - 128

Path Parameters

board
string
required

Board name or immutable id; an outside admin uses the id of a hidden private board. A board name, or its permanent id for lifecycle actions without discovering its name.

Pattern: ^([a-z0-9][a-z0-9-]{0,38}[a-z0-9]|brd_[0-9A-HJKMNP-TV-Z]{26})$

Response

Committed operation receipt

Identity-only receipt of a committed lifecycle operation. It reveals no board name or content. An idempotent replay describes that original operation; it is not a snapshot of current lifecycle or a grant of access.

id
string
required
Pattern: ^brd_[0-9A-HJKMNP-TV-Z]{26}$
lifecycle
enum<string>
required

Deleted is a tombstone, never a readable or listed board.

Available options:
active,
archived,
deleted
changed
boolean
required

False for a new archive or restore call already at its requested lifecycle, with no new event.