Nimbu Developer Docs
ReferenceChannels

Empty channel

POST
/channels/{channel_id}/empty

Schedules a background job that removes every entry from the channel. Requires an admin user token and a confirmation payload that matches the channel slug.

Authorization

AuthorizationBearer <token>

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

In: header

X-Nimbu-Site<token>

Identifier of the site context when authenticating with a personal access token.

In: header

Path Parameters

channel_id*string

Channel identifier (id or slug)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

confirm*string

Must match the channel slug to confirm the destructive action.

Response Body

application/json

curl -X POST "https://example.com/channels/string/empty" \  -H "Content-Type: application/json" \  -d '{    "confirm": "string"  }'
{
  "status": "string",
  "message": "string"
}
Empty