Validate insight authoring

POST 
/v1/brains/:brain_id/insights/validate

Advisory LLM check for an insight definition. Returns actionable feedback (vague description, missing categorical options, etc.) without persisting anything. Accepts a partial draft (any subset of authoring fields, at least one required). Permissions - brains.write. API keys - manage.

Request

Responses

200

Validation result

400

BadRequest

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

401

Unauthorized

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

404

The specified resource was not found

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

500

Internal Server Error

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

503

A downstream dependency is temporarily unavailable

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789