Qyra
ReferenceUntagged

Update AI agent review item status

Update the status of an AI agent review item (e.g. dismiss it)

PATCH/api/v1/aiAgents/admin/review-items/{fingerprint}

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.

Path parameters

NameTypeRequiredDescription
fingerprintstringYes

Request body

{
  "boardPosition": 0,
  "dismissedReason": {},
  "status": "triage"
}

Responses

200 — Success

{
  "results": {
    "updatedAt": "2024-01-01T00:00:00.000Z",
    "createdAt": "2024-01-01T00:00:00.000Z",
    "createdByUserUuid": "string",
    "boardPosition": 0,
    "prWritebackMessage": "string",
    "prWritebackStatus": {},
    "prState": {},
    "linkedPrUrl": "string",
    "linkedJiraIssueUrl": "string",
    "linkedIssueUrl": "string",
    "statusUpdatedByUserUuid": "string",
    "statusUpdatedAt": "2024-01-01T00:00:00.000Z",
    "findingCount": 0,
    "lastSeenAt": "2024-01-01T00:00:00.000Z",
    "firstSeenAt": "2024-01-01T00:00:00.000Z",
    "assignedToUserUuid": "string",
    "ownerType": "semantic_layer_owner",
    "dismissedReason": {},
    "status": "triage",
    "targetRefs": [
      {
        "modelName": "string",
        "type": "model"
      }
    ],
    "priority": "urgent",
    "primaryRootCause": "semantic_layer",
    "description": "string",
    "title": "string",
    "agentUuid": "string",
    "projectUuid": "string",
    "organizationUuid": "string",
    "source": "ai_finding",
    "fingerprint": "string",
    "uuid": "string",
    "latestFinding": {
      "createdAt": "2024-01-01T00:00:00.000Z",
      "projectContextEntry": {
        "objects": [
          "string"
        ],
        "terms": [
          "string"
        ],
        "content": "string",
        "kind": "definition",
        "id": "string",
        "op": "create"
      },
      "recommendation": {
        "targetRefs": [
          {
            "modelName": "string",
            "type": "model"
          }
        ],
        "rationale": "string",
        "title": "string",
        "actionType": "update_semantic_yaml"
      },
      "evidenceExcerpts": [
        {
          "redacted": true,
          "text": "string",
          "source": "user_prompt"
        }
      ],
      "targetRefs": [
        {
          "modelName": "string",
          "type": "model"
        }
      ],
      "fixTargets": [
        "semantic_yaml_patch"
      ],
      "subcategories": [
        "string"
      ],
      "agentUuid": "string",
      "projectUuid": "string",
      "threadUuid": "string",
      "promptUuid": "string",
      "uuid": "string"
    },
    "remediation": {
      "updatedAt": "2024-01-01T00:00:00.000Z",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "resolvedAt": "2024-01-01T00:00:00.000Z",
      "resolvedByUserUuid": "string",
      "createdByUserUuid": "string",
      "retryPrompt": "string",
      "errorMessage": "string",
      "status": "queued",
      "previewThreadUuid": "string",
      "previewAgentUuid": "string",
      "previewProjectUuid": "string",
      "linkedPrUrl": "string",
      "pullRequestUuid": "string",
      "workThreadUuid": "string",
      "sourceAgentUuid": "string",
      "sourceProjectUuid": "string",
      "sourceThreadUuid": "string",
      "sourcePromptUuid": "string",
      "sourceFindingUuid": "string",
      "organizationUuid": "string",
      "fingerprint": "string",
      "uuid": "string"
    },
    "writebackEligibility": {
      "reason": null,
      "strategy": "semantic_layer",
      "provider": "github",
      "eligible": true
    },
    "writebackEligible": true,
    "nominator": {
      "email": "string",
      "name": "string"
    },
    "nominationReason": "string",
    "sourceMemory": {
      "slug": "string",
      "uuid": "string"
    },
    "projectContextEntry": {
      "objects": [
        "string"
      ],
      "terms": [
        "string"
      ],
      "content": "string",
      "kind": "definition",
      "id": "string",
      "op": "create"
    }
  },
  "status": "ok"
}

default — Error

{
  "error": {
    "data": "string",
    "message": "string",
    "name": "string",
    "statusCode": 0
  },
  "status": "error"
}