Skip to content

Soft-delete a category (console plane, human authority)

DELETE
/v1/admin/orgs/{org_id}/projects/{project_id}/categories/{id}

SOFT delete the category (D9 never-hard-delete): the row + its references + history survive as training data. The soft-delete is a self-tombstone (merged_into = self) so it drops out of the default registry list; an audit/undo row (action=retire) records it. Console-only; a foreign id is 404.

org_id
required
string
project_id
required
string
id
required
string

Soft-deleted.

The result of a soft-delete (the row + history survive as training data; D9).

object
status
required
string
Example
deleted
category_id
required
string
merged_into
string

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Resource not found.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope