Remove a Forward Insight

DELETE/insights/{insight_id}

Takes a Forward Insight off your charts. It is archived, as when you click its trash button in the definition's Forward Insights tab. The study and its runs are kept.

Scope	Heavy call	Long poll	CLI
`scripts:write`	No	No	`chartnaut insights rm`

Guidance

The API cannot restore an archived insight. To show the same card again, call Create a Forward Insight with the same run.
A retry after the first call landed answers 404 not_found. Treat that as done.
You do not need this to replace an insight: creating one with the same name on the same definition archives the old one.

Path parameters

Name	Type	Description
`insight_id`	string	The insight's id, such as `ins_842`

Response

204 with no body.

Status codes

Status	Code	Meaning
`204`	-	The insight was archived and is off your charts
`404`	`not_found`	No active insight with that id on your account
`502`	`internal`	The change failed. Retry

Example request

curl -X DELETE https://api.chartnaut.com/v1/insights/ins_842 \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

204 No Content

HTTP/1.1 204 No Content

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No Forward Insight ins_842."
  }
}

From the CLI

chartnaut insights rm ins_61

Command reference