Skip to main content

Generate AI Dashboard

POST 

/dashboard/:dashboardID/generate

Generate or refine the layout of an AI Dashboard from a prompt, the same as the prompt bar in Admin. Each call that changes the layout replaces the stored one and saves a new version. A call that changes nothing saves no version, but still counts as a generation.

See AI Dashboard for how the layout is built.

Without run_user, the request edits your own setup. With run_user, it builds or edits that TagoRUN user's own copy, with Personal AI Dashboards for Run users on or off. The generator then sees only the devices that user can access, and follows the dashboard's ai_instructions. A user without a copy starts from your setup when per_user is off, and from an empty dashboard when it is on. The user does not need AI dashboard generation for you to build their copy.

TagoRUN users send their own prompts to Generate an AI Dashboard as a Run User instead; this route refuses their tokens.

Requires a profile token with Full or Write permission, or an Analysis token whose Access Management policy allows Dashboard → Edit on the dashboard. Generations count against the profile owner's AI requests, or spend AI credits on a paid model. See TagoAI Service.

A generation times out after 120 seconds. Only one generation runs at a time on your setup or on each user's version, and at most three at once per profile. Send the next request for the same user after the previous one finishes, and do not retry blindly after a timeout: each run is billed and can save a version.

Request​

Responses​

Layout generated and saved