Sign in

Draft Overview dashboard widgets from a natural-language request

Drafts 1-6 widgets (exactly 1 when editWidget is set) in the shape the widget editor saves. Filter values are grounded in the organization's own data and every widget is re-validated against the frontend widget rules; widgets that fail are dropped with a warning. Nothing is persisted. Requires org.edit_dashboard. Billed as AI usage under the overview_dashboard feature area (operation widget_draft); a fallback draft is recorded but not charged.

post/overview/widget-drafts

Request body

editWidgetobject

The widget to change (a SaveWidgetPayload). When present, exactly one widget comes back: this one with the requested change applied.

promptstring required
requestIdstring uuid

The frontend's own id for this request. Send it to be able to stop the draft with POST /overview/widget-drafts/{requestId}/cancel.

Response

Validated widget drafts

Changes

Changed in 1 of the 5 revisions of this API.1