Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Responses
200 — Success
{
"results": [
{
"finding": {
"recommendation": {
"targetRefs": [
{
"modelName": "string",
"type": "model"
}
],
"rationale": "string",
"title": "string",
"actionType": "update_semantic_yaml"
},
"evidenceExcerpts": [
{
"redacted": true,
"text": "string",
"source": "user_prompt"
}
],
"fixTargets": [
"semantic_yaml_patch"
],
"subcategories": [
"string"
],
"primaryRootCause": "semantic_layer",
"reviewItemUuid": "string",
"uuid": "string"
},
"errorMessage": "string",
"responsePreview": "string",
"prompt": "string",
"runScope": {
"dryRun": true,
"agentUuid": "string",
"projectUuid": "string",
"endedAt": "string",
"startedAt": "string",
"type": "backfill"
},
"createdAt": "2024-01-01T00:00:00.000Z",
"promotionReason": "string",
"promotedToFinding": true,
"confidence": "low",
"implicitSignalSources": [
"next_user_correction"
],
"signal": "normal_refinement",
"agentUuid": "string",
"projectUuid": "string",
"threadUuid": "string",
"promptUuid": "string",
"runUuid": "string",
"uuid": "string"
}
],
"status": "ok"
}default — Error
{
"error": {
"data": "string",
"message": "string",
"name": "string",
"statusCode": 0
},
"status": "error"
}