--- title: "Get AI Insight" method: POST path: "/ai-insight/{id}/get-item" tags: ["AI Insight"] --- # Get AI Insight `POST /ai-insight/{id}/get-item` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/ai-insight/{id}/get-item` - Auth: API key in header `APIKey` - TypeScript: (a function with typed inputs; its response is checked against the schema) Endpoint to retrieve a single AI Insight by ID ## Path parameters - `id` string, uuid, required ## Request body - object - `select` AIInsightSelectSchema: Select schema for AIInsight. Set fields to true to include them in the response. - `_id` boolean - `createdAt` boolean - `updatedAt` boolean - `deletedAt` boolean - `projectId` boolean - `insightType` boolean - `status` boolean - `severity` boolean - `classification` boolean - `fingerprint` boolean - `title` boolean - `detailMarkdown` boolean - `serviceName` boolean - `telemetryServiceId` boolean - `telemetryExceptionId` boolean - `traceId` boolean - `metricName` boolean - `evidence` boolean - `firstSeenAt` boolean - `lastSeenAt` boolean - `occurrenceCount` boolean - `triageAiRunId` boolean - `fixAiRunId` boolean - `triageSummaryMarkdown` boolean - `triageCompletedAt` boolean - `humanVerdict` boolean - `humanVerdictAt` boolean - `humanVerdictByUserId` boolean ## Response `200` Successful response - object - `data` AIInsight - `_id` string, uuid: ID of this object. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `createdAt` object: Date and Time when the object was created. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `version` number: Object version - `projectId` string, uuid, required: ID of the project this insight belongs to. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `insightType` 'NewException' | 'ExceptionSpike' | 'ErrorLogSpike' | 'TraceLatencyRegression' | 'MetricDrift' | 'DataDrift' | 'DeployRegression' | 'ProfileHotspot' | 'TraceSlowOperation' | 'TraceFailingOperation' | 'TraceMissingTracing' | 'ExceptionMissingStackTrace' | 'LogErrorPattern' | 'LogMissingLogging' | 'LogNoisyPattern' | 'MetricHighCardinality' | 'MetricHistogramBuckets' | 'MetricMissingMetrics' | 'MetricMissingRequestMetrics', required: Which deterministic detector produced this insight: NewException, ExceptionSpike, ErrorLogSpike, TraceLatencyRegression or MetricDrift. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `status` 'Detected' | 'ActionRequired' | 'FixOpened' | 'Resolved' | 'Dismissed', required: Lifecycle of the insight. Detected is the defensive initial state — the scanner routes to ActionRequired or FixOpened in the same tick; Resolved and Dismissed are human actions. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `severity` 'High' | 'Medium' | 'Low', required: How urgent this insight is (High, Medium or Low), assigned deterministically by the detector. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `classification` string: AI triage verdict: code-fault, user-error, expected-denial, infrastructure or unknown. Automatic fix pull requests are only opened for code-fault. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `fingerprint` string, required: The detector's stable dedupe key for this finding. Recurring detections refresh the existing non-terminal insight with the same fingerprint. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `title` string, required: One-line human-readable summary of the finding. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `detailMarkdown` string, required: The deterministic evidence rendered as markdown: real counts, baselines and multipliers written by the detector at detect time. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `serviceName` string: Name of the telemetry service this insight is about. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `telemetryServiceId` string, uuid: ID of the telemetry service this insight is about. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `telemetryExceptionId` string, uuid: The telemetry exception behind this insight (for NewException and ExceptionSpike insights). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `traceId` string: A representative slow trace (for TraceLatencyRegression insights). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `metricName` string: The drifting metric's name (for MetricDrift insights). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `evidence` object: The deterministic evidence computed at detect time: counts, baselines, multipliers and (for latency insights) span-tree findings. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `firstSeenAt` object, required: When this finding was first detected. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `lastSeenAt` object, required: When this finding was most recently re-detected by the scanner. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `occurrenceCount` number, required: How many scanner ticks have detected this finding. Incremented on each dedupe refresh. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `triageAiRunId` string, uuid: The budgeted, read-only AI triage run enqueued for this insight (an Investigation AIRun). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `fixAiRunId` string, uuid: The AI agent fix task queued for this insight (a CodeFix AIRun that opens a pull request, ready for review). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `triageSummaryMarkdown` string: The AI triage analysis for this insight: probable root cause, blast radius and suggested action, with citations. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `triageCompletedAt` object: When the AI triage analysis completed. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `humanVerdict` 'Confirmed' | 'Dismissed': The one-click human verdict on this insight (Confirmed or Dismissed). Null until a user weighs in. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `humanVerdictAt` object: When the human verdict was recorded (or last changed). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] - `humanVerdictByUserId` string, uuid: The user who recorded (or last changed) the human verdict. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member], Update: [No access - you don't have permission for this operation] ## Other responses - `400`: Bad request. This response indicates that the request was malformed or contained invalid data. - `401`: Unauthorized. This response indicates that the request requires user authentication. - `402`: Payment Required. This response indicates that the request requires payment or a valid subscription. - `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it. - `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each. - `405`: Project not found. This response indicates that the requested project does not exist or is not accessible. - `408`: Request Timeout. This response indicates that the server timed out waiting for the request. - `415`: Unable to reach server. This response indicates that the server is currently unreachable or down. - `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource. - `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. --- [API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)