Skip to main content

Metadata Configuration API

Space-scoped administration of criticality levels, sensitivity levels, and maintenance statuses. These configurable values drive the options available in the Metadata API.

All endpoints are scoped to a space via the {slug} path parameter and require Space Admin permissions.

Endpoints Overview​

Criticality Levels​

MethodEndpointDescription
GET/spaces/{slug}/config/criticality-levelsList levels
POST/spaces/{slug}/config/criticality-levelsCreate level
PATCH/spaces/{slug}/config/criticality-levels/{level_id}Update level
DELETE/spaces/{slug}/config/criticality-levels/{level_id}Delete level
POST/spaces/{slug}/config/criticality-levels/seedSeed defaults

Sensitivity Levels​

MethodEndpointDescription
GET/spaces/{slug}/config/sensitivity-levelsList levels
POST/spaces/{slug}/config/sensitivity-levelsCreate level
PATCH/spaces/{slug}/config/sensitivity-levels/{level_id}Update level
DELETE/spaces/{slug}/config/sensitivity-levels/{level_id}Delete level
POST/spaces/{slug}/config/sensitivity-levels/seedSeed defaults

Maintenance Statuses​

MethodEndpointDescription
GET/spaces/{slug}/config/maintenance-statusesList statuses
POST/spaces/{slug}/config/maintenance-statusesCreate status
PATCH/spaces/{slug}/config/maintenance-statuses/{status_id}Update status
DELETE/spaces/{slug}/config/maintenance-statuses/{status_id}Delete status
POST/spaces/{slug}/config/maintenance-statuses/seedSeed defaults

Criticality Levels​

List Levels​

GET /spaces/{slug}/config/criticality-levels

Returns all criticality levels configured for the space.

Create Level​

POST /spaces/{slug}/config/criticality-levels

Requires: Space Admin

Request Body​

{
  "name": "Critical",
  "color": "#DC2626",
  "sort_order": 1,
  "description": "Business-critical data requiring highest governance"
}

Update Level​

PATCH /spaces/{slug}/config/criticality-levels/{level_id}

Requires: Space Admin

All fields are optional — only provided fields are updated.

Delete Level​

DELETE /spaces/{slug}/config/criticality-levels/{level_id}

Requires: Space Admin

Soft-deletes the criticality level. Returns 404 if not found.

Seed Defaults​

POST /spaces/{slug}/config/criticality-levels/seed

Requires: Space Admin

Populates the space with a standard set of criticality levels (Critical, High, Medium, Low). Existing levels are not duplicated.

Sensitivity Levels​

Follows the same CRUD pattern as Criticality Levels. Endpoints under /spaces/{slug}/config/sensitivity-levels.

Create Level​

{
  "name": "PII",
  "color": "#F59E0B",
  "sort_order": 1,
  "description": "Contains personally identifiable information"
}

Maintenance Statuses​

Follows the same CRUD pattern as Criticality Levels. Endpoints under /spaces/{slug}/config/maintenance-statuses.

Create Status​

{
  "name": "Actively Maintained",
  "slug": "actively_maintained",
  "color": "#10B981",
  "sort_order": 1
}