Reset Knowledge Base Structure

POST /knowledge-bases/{kb_id}/reset-structure

Delete hubs and proposed edges; keep items, confirmed edges and rejected ones.

A rejected edge is a tombstone (RULE KE-1). Sweeping it would turn “an operator refused this topology” into “the organize stage may try again”, which is the one thing a reset must not undo (D-739).

Role floor

Requires admin or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
kb_id	path	string (uuid)	required	—

Responses

Status	Description	Body
200	Successful Response	ResetResult
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X POST https://your-deployment.example.com/knowledge-bases/{kb_id}/reset-structure \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — ResetResult

Field	Type		Notes
hubs_deleted	integer	optional	Default 0.
proposed_edges_deleted	integer	optional	Default 0.
hub_edges_cascaded	integer	optional	Default 0.
rejected_edges_kept	integer	optional	Default 0.
confirmed_edges_kept	integer	optional	Default 0.