---
title: "Create AI agent review item"
method: POST
path: "/api/v1/aiAgents/admin/review-items"
---

# Create AI agent review item

`POST /api/v1/aiAgents/admin/review-items`

Create a manual AI agent issue

## Request body

- CreateAiAgentReviewItem
  - `targetRefs` AiAgentTargetRef[], required
    - union
      - union
        - object
          - `modelName` string, required
          - `type` 'model', required
        - object
          - `exploreName` string, required
          - `modelName` string, required
          - `type` 'explore', required
        - object
          - `exploreName` string
          - `joinName` string, required
          - `modelName` string, required
          - `type` 'join', required
        - object
          - `dimensionName` string, required
          - `modelName` string, required
          - `type` 'dimension', required
        - object
          - `dimensionName` string
          - `metricName` string, required
          - `modelName` string, required
          - `type` 'metric', required
        - object
          - `dimensionName` string, required
          - `parentDimensionName` string, required
          - `modelName` string, required
          - `type` 'additional_dimension', required
        - object
          - `fieldName` string, required
          - `exploreName` string, required
          - `modelName` string, required
          - `type` 'required_filter', required
        - object
          - `targetName` string, required
          - `targetType` 'model' | 'dimension' | 'metric', required
          - `modelName` string, required
          - `type` 'ai_hint', required
      - object
        - `agentUuid` string, required
        - `type` 'agent', required
      - object
        - `setting` 'instructions' | 'knowledge_documents' | 'data_access' | 'self_improvement' | 'sql_mode' | 'mcp_servers' | 'explore_tags' | 'space_access' | 'user_or_group_access' | 'unknown', required
        - `type` 'agent_config', required
      - object
        - `capabilityKey` string, required
        - `type` 'product_capability', required
      - object
        - `key` string, required
        - `type` 'runtime', required
      - object
        - `tileUuid` string, nullable, required
        - `dashboardUuid` string, nullable, required
        - `chartUuid` string, nullable, required
        - `type` 'content', required
  - `priority` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
  - `primaryRootCause` 'semantic_layer' | 'project_context' | 'agent_configuration' | 'product_capability' | 'runtime_reliability' | 'feedback_quality' | 'not_a_failure' | 'ambiguous', required
  - `assignedToUserUuid` string, nullable, required
  - `agentUuid` string, nullable, required
  - `projectUuid` string, required
  - `description` string, nullable, required
  - `title` string, required

## Response `201`

Created

- ApiAiAgentReviewItemResponse
  - `results` AiAgentReviewItemSummary, required
    - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `createdByUserUuid` string, nullable, required
    - `boardPosition` number, double, nullable, required
    - `prWritebackMessage` string, nullable, required
    - `prWritebackStatus` 'queued' | 'running' | 'completed' | 'failed', required
    - `prState` 'open' | 'merged' | 'closed', required
    - `linkedPrUrl` string, nullable, required
    - `linkedIssueUrl` string, nullable, required
    - `statusUpdatedByUserUuid` string, nullable, required
    - `statusUpdatedAt` string, date-time, required
    - `findingCount` number, double, required
    - `lastSeenAt` string, date-time, required
    - `firstSeenAt` string, date-time, required
    - `assignedToUserUuid` string, nullable, required
    - `ownerType` 'semantic_layer_owner' | 'agent_admin' | 'product' | 'support' | 'unknown', required
    - `dismissedReason` 'not_actionable' | 'expected_behavior' | 'duplicate' | 'low_confidence' | 'other', required
    - `status` 'triage' | 'open' | 'in_progress' | 'resolved' | 'dismissed' | 'duplicate', required
    - `targetRefs` AiAgentTargetRef[], required
      - union
        - union
          - object
            - `modelName` string, required
            - `type` 'model', required
          - object
            - `exploreName` string, required
            - `modelName` string, required
            - `type` 'explore', required
          - object
            - `exploreName` string
            - `joinName` string, required
            - `modelName` string, required
            - `type` 'join', required
          - object
            - `dimensionName` string, required
            - `modelName` string, required
            - `type` 'dimension', required
          - object
            - `dimensionName` string
            - `metricName` string, required
            - `modelName` string, required
            - `type` 'metric', required
          - object
            - `dimensionName` string, required
            - `parentDimensionName` string, required
            - `modelName` string, required
            - `type` 'additional_dimension', required
          - object
            - `fieldName` string, required
            - `exploreName` string, required
            - `modelName` string, required
            - `type` 'required_filter', required
          - object
            - `targetName` string, required
            - `targetType` 'model' | 'dimension' | 'metric', required
            - `modelName` string, required
            - `type` 'ai_hint', required
        - object
          - `agentUuid` string, required
          - `type` 'agent', required
        - object
          - `setting` 'instructions' | 'knowledge_documents' | 'data_access' | 'self_improvement' | 'sql_mode' | 'mcp_servers' | 'explore_tags' | 'space_access' | 'user_or_group_access' | 'unknown', required
          - `type` 'agent_config', required
        - object
          - `capabilityKey` string, required
          - `type` 'product_capability', required
        - object
          - `key` string, required
          - `type` 'runtime', required
        - object
          - `tileUuid` string, nullable, required
          - `dashboardUuid` string, nullable, required
          - `chartUuid` string, nullable, required
          - `type` 'content', required
    - `priority` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
    - `primaryRootCause` 'semantic_layer' | 'project_context' | 'agent_configuration' | 'product_capability' | 'runtime_reliability' | 'feedback_quality' | 'not_a_failure' | 'ambiguous', required
    - `description` string, required
    - `title` string, required
    - `agentUuid` string, nullable, required
    - `projectUuid` string, nullable, required
    - `organizationUuid` string, required
    - `source` 'ai_finding' | 'manual', required
    - `fingerprint` string, required
    - `uuid` string, required
    - `latestFinding` object, nullable, required
      - `createdAt` string, date-time, required
      - `projectContextEntry` AiAgentJudgeProjectContextEntry, required
        - `objects` AiProjectContextObjectRef[], required
          - union
            - string
            - union
              - …
        - `terms` string[], required
        - `content` string, required
        - `kind` 'definition' | 'context', required
        - `id` string, nullable, required
        - `op` 'create' | 'update', required
      - `recommendation` AiAgentRecommendation, required
        - `targetRefs` AiAgentTargetRef[], required
          - union
            - union
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `rationale` string, required
        - `title` string, required
        - `actionType` 'update_semantic_yaml' | 'update_agent_instructions' | 'add_knowledge_document' | 'enable_data_access' | 'enable_sql_mode' | 'enable_self_improvement' | 'configure_mcp_server' | 'adjust_explore_tags' | 'update_access' | 'route_to_product_work' | 'request_more_evidence' | 'no_action', required
      - `evidenceExcerpts` AiAgentEvidenceExcerpt[], required
        - `redacted` boolean, required
        - `text` string, required
        - `source` 'user_prompt' | 'assistant_answer' | 'next_user_prompt' | 'conversation_context' | 'tool_call' | 'tool_result' | 'agent_config', required
      - `targetRefs` AiAgentTargetRef[], required
        - union
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - object
            - `agentUuid` string, required
            - `type` 'agent', required
          - object
            - `setting` 'instructions' | 'knowledge_documents' | 'data_access' | 'self_improvement' | 'sql_mode' | 'mcp_servers' | 'explore_tags' | 'space_access' | 'user_or_group_access' | 'unknown', required
            - `type` 'agent_config', required
          - object
            - `capabilityKey` string, required
            - `type` 'product_capability', required
          - object
            - `key` string, required
            - `type` 'runtime', required
          - object
            - `tileUuid` string, nullable, required
            - `dashboardUuid` string, nullable, required
            - `chartUuid` string, nullable, required
            - `type` 'content', required
      - `fixTargets` AiAgentFixTarget[], required
      - `subcategories` string[], required
      - `agentUuid` string, required
      - `projectUuid` string, required
      - `threadUuid` string, required
      - `promptUuid` string, required
      - `uuid` string, required
    - `remediation` AiAgentReviewRemediation, required
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `resolvedAt` string, date-time, nullable, required
      - `resolvedByUserUuid` string, nullable, required
      - `createdByUserUuid` string, nullable, required
      - `retryPrompt` string, nullable, required
      - `errorMessage` string, nullable, required
      - `status` 'queued' | 'running' | 'pr_open' | 'preview_ready' | 'resolved' | 'failed', required
      - `previewThreadUuid` string, nullable, required
      - `previewAgentUuid` string, nullable, required
      - `previewProjectUuid` string, nullable, required
      - `linkedPrUrl` string, nullable, required
      - `pullRequestUuid` string, nullable, required
      - `workThreadUuid` string, nullable, required
      - `sourceAgentUuid` string, required
      - `sourceProjectUuid` string, required
      - `sourceThreadUuid` string, nullable, required
      - `sourcePromptUuid` string, nullable, required
      - `sourceFindingUuid` string, nullable, required
      - `organizationUuid` string, required
      - `fingerprint` string, required
      - `uuid` string, required
    - `writebackEligibility` union, required
      - object
        - `reason` null, nullable, required
        - `strategy` 'semantic_layer' | 'project_context', required
        - `provider` 'github' | 'gitlab', required
        - `eligible` true, required
      - object
        - `reason` 'reviews_disabled' | 'unsupported_root_cause' | 'missing_project' | 'missing_agent' | 'missing_project_context_entry' | 'project_context_disabled' | 'unsupported_source_control' | 'git_app_not_installed' | 'missing_writeback_config' | 'pull_request_open' | 'source_thread_writeback_exists' | 'terminal_state' | 'writeback_in_progress', required
        - `strategy` 'semantic_layer' | 'project_context', required
        - `provider` 'github' | 'gitlab', required
        - `eligible` false, required
    - `writebackEligible` boolean, required — Legacy boolean kept for current clients. New clients should use writebackEligibility for the blocking reason and provider.
  - `status` 'ok', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lightdash/apis/lightdash-api.md) · [All operations](https://skmtc.net/lightdash/apis/lightdash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightdash/lightdash-api/versions/40c933755c9a/schema)