Skip to main content

AI Classification API

AI-powered data classification — trigger classification for products and review suggestions.

Endpoints Overview

MethodEndpointDescription
POST/classify/product/{product_id}Classify product
GET/classify/suggestionsList suggestions
POST/classify/suggestions/{id}/reviewReview suggestion
POST/classify/suggestions/bulk-reviewBulk review

Classify Product

POST /classify/product/{product_id}

Triggers AI classification for all fields in a product. Creates suggestions for steward review.

{
"include_llm": true,
"include_lineage": true
}

Response

{
"product_id": "...",
"total_suggestions": 12,
"pattern_matches": 5,
"llm_suggestions": 4,
"lineage_suggestions": 3,
"suggestions": [...]
}

List Suggestions

GET /classify/suggestions?product_id=...&status=pending
ParameterTypeDescription
product_idUUIDFilter by product
space_idUUIDFilter by space
statusstringpending, accepted, rejected

Review Suggestion

POST /classify/suggestions/{suggestion_id}/review
{
"action": "accept"
}

Bulk Review

POST /classify/suggestions/bulk-review
{
"suggestion_ids": ["uuid-1", "uuid-2"],
"action": "accept"
}