delete-insights
dci delete-insights [flags]
Deletes all insights matching the specified key from the batch source.
This removes the insight and all its associated resource results.
For single-insight deletion, use DELETE /source/\{sourceID\}/insight/\{insightKey\} instead.
Examples
# Preview which insights match the key, without sending a request.
dci delete-insights --insight-key <insight-key> --dry-run
# Delete every batch-source insight with that key, and their resource results, without a prompt (interactive terminals ask first).
dci delete-insights --insight-key <insight-key> --yes
Exit code 0 and no output; `dci list-insights --source public-api` no longer lists the insight.
Flags
| Flag | Type | Default | Example | Description |
|---|---|---|---|---|
--insight-key | string | The unique key identifying the insight to delete. |
Every command also accepts the CLI-wide flags for output shaping — see Output formats and Table output options.
Output
On success, this command produces no response data.
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
HTTP status to exit code mapping
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 500 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Related
- delete-insight — Delete an insight
- list-insights — List insights
- create-insights — Create insights (batch)
- API reference: DELETE /insights/v1/results
Aliases: delete-insight-results