---
title: "Update Insight Status"
method: PUT
path: "/insights/v1/results/source/{sourceID}/insight/{insightKey}/status"
tags: ["Insights"]
deprecated: true
---

# Update Insight Status

`PUT /insights/v1/results/source/{sourceID}/insight/{insightKey}/status`

> **Deprecated.**

Updates the display status (e.g. actionable, acknowledged, dismissed) of a single insight.
Only insights created via the public API can have their status changed.
Deprecated: use the status field on the create/update insight endpoint instead.

## Path parameters

- `sourceID` 'public-api', required
- `insightKey` string, required

## Request body

- UpdateStatusRequest — Request body for updating an insight's display status.
  - `status` 'actionable' | 'acknowledged' | 'optimized' | 'dismissed' | 'in progress' | 'upgrade needed' | 'permissions needed', required — The display status of the insight.
  - `dismissalDetails` DismissalDetails — Details for why an insight was dismissed.
    - `reason` 'not relevant' | 'not enough information' | 'not worth the effort' | 'inaccurate optimization opportunities' — The reason for dismissal.
    - `comment` string — An optional free-text comment providing additional context.

## Response `204`

Status updated successfully

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `404` — Not Found - The requested resource does not exist.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)