AI Steward API

The AI Steward API surfaces governance maintenance work for a space. It is mounted under /api/v1.0/spaces/{slug}/ai-steward and requires the AI classification feature gate plus the caller's space permissions.

Endpoints Overview

Method	Endpoint	Description
POST	/spaces/{slug}/ai-steward/scan	Run an AI Steward scan for the space
GET	/spaces/{slug}/ai-steward/inbox	List normalized stewardship inbox items
GET	/spaces/{slug}/ai-steward/suggestions	List legacy pending metadata suggestions
POST	/spaces/{slug}/ai-steward/inbox/{item_id}/actions/{action_type}	Run an item action
POST	/spaces/{slug}/ai-steward/inbox/action	Bulk approve or reject suggestions

Run Scan

POST /spaces/{slug}/ai-steward/scan

Runs the space scan and returns a summary of created or updated work items.

List Inbox

GET /spaces/{slug}/ai-steward/inbox?status=open&severity=high&limit=50

Supported filters include status, source_type, severity, asset_type, q, assigned_to, due, include_snoozed, skip, and limit.

Run Item Action

POST /spaces/{slug}/ai-steward/inbox/{item_id}/actions/{action_type}

{
  "payload": {
    "comment": "Converted to a remediation ticket."
  }
}

Actions depend on item type and may convert suggestions into catalog updates, tickets, reminders, or lifecycle state changes.

Bulk Review

POST /spaces/{slug}/ai-steward/inbox/action

{
  "suggestion_ids": ["uuid-1", "uuid-2"],
  "status": "approved"
}

Approving description suggestions applies the suggested value to the product or field after permission checks.