Update a Forward Insight

PATCH/insights/{insight_id}

Renames a Forward Insight or changes its description. The numbers on its card stay as they are.

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

Guidance

Send name, description or both. A body with neither answers 400 invalid_request.
To change the numbers or the breakdown, change the study, run it again and call Create a Forward Insight with the same name. It replaces this one.
The new name shows on the chart card and in the definition's Forward Insights tab.

Path parameters

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

Request body

At least one field.

Field	Type	Required	Description
`name`	string	No	New name, 1 to 120 characters
`description`	string	No	New description, at most 2,000 characters. `""` clears it

Response

200 with the updated Forward Insight.

Status codes

Status	Code	Meaning
`200`	-	The change was made
`400`	`invalid_request`	The body is not JSON or has neither field, `name` is empty or too long, or `description` is too long
`404`	`not_found`	No active insight with that id on your account
`502`	`internal`	The change failed. Retry

Example request

curl -X PATCH https://api.chartnaut.com/v1/insights/ins_842 \
  -H "Authorization: Bearer cn_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ORB follow-through, long vs short"
  }'

Example response

200 OK

{
  "id": "ins_842",
  "name": "ORB follow-through, long vs short",
  "description": "How often a BTC opening range break reached 1R before the stop, long and short.",
  "definition": "orb-breakout",
  "study": "orb-follow-through",
  "study_version": 4,
  "instrument": "BTC",
  "timeframe": "1h",
  "profile": null,
  "window": {
    "from": "2024-09-27T00:00:00Z",
    "to": "2026-09-26T23:00:00Z"
  },
  "scope_dimensions": ["direction"],
  "app_url": "https://terminal.chartnaut.com/morpheus/studies/311/runs/5120",
  "created_at": "2026-09-27T10:14:52.381207Z",
  "updated_at": "2026-09-27T10:31:07.904115Z"
}

400 Bad Request

{
  "error": {
    "code": "invalid_request",
    "message": "Body must be JSON with name and/or description."
  }
}

From the CLI

chartnaut insights update ins_61 --name "Median move after a divergence"

--description changes the description; --json prints this response. Command reference