Delete a draft incident

DELETE/workspaces/{workspace}/status/incidents/{incident}

Deletes an incident that was never posted. Posted incidents stay on the record; resolve them instead.

Authentication

Send an API token as a bearer token. This endpoint needs a read and write token, made by an editor, admin or owner. Create one in My account → API tokens; see scopes and roles.

Authorization: Bearer 42|bynh_pat_•••••••Header

Path parameters

workspacestringRequired
Your workspace slug, e.g. dokan.
incidentintegerRequired
Incident id.

Response

204 No content

Empty body.

Rate limits

This endpoint counts toward your general limit of 120 requests a minute. When you go over, wait for the number of seconds in Retry-After.

Errors

401The token is missing, wrong, revoked or expired.

403The token is read-only (message: “This token is read-only. Create a read and write token to make changes.”). Or: The token’s owner is a viewer (“Viewers can read everything but can’t change it.”), or the workspace’s editing is paused (a billing message, e.g. “Your trial has ended, so editing is paused. …”).

404The token belongs to another workspace, or its owner is no longer a member.

422The incident was posted: {"message": "Posted incidents stay on the record. Resolve it instead."} (no errors object).

Every error is JSON with a message. See Errors.

Next →Post an incident update

curl -X DELETE "https://api.bynh.io/api/v1/workspaces/dokan/status/incidents/1" \
  -H "Authorization: Bearer $BYNH_TOKEN" \
  -H "Accept: application/json"

Response204 No content

Empty

No body. The change is saved.

Examples use Dokan, a sample workspace. Responses are shortened where lists are long.