provider dashboards PATCH /api/projects/{project_id}/dashboards/{id}/widgets/batch_update/
@utdk/posthog /api/projects/{project_id}/dashboards/{id}/widgets/batch_update/
dashboards_update_widgets_batch
Update the settings of existing widgets in place, atomically — config, name, and description. Each entry targets a widget by its tile_id and reuses the same write path as the dashboard PATCH endpoint. The widget_type is immutable. This edits widget settings only (config, name, description); tile placement (layouts, show_description) is a dashboard concern — use the dashboard PATCH endpoint or reorder_tiles for that. All updates succeed or fail together. To add new widgets, use the widgets/batch POST endpoint; to remove one, use delete_tile.
format query
enum: json, txt
id path required
A unique integer value identifying this dashboard.
integer
project_id path required
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
string

Try it

Authentication
Configure credentials for PostHog API
dashboardsUpdateWidgetsBatch
PATCH/api/projects/{project_id}/dashboards/{id}/widgets/batch_update/
Update the settings of existing widgets in place, atomically — config, name, and description. Each entry targets a widget by its tile_id and reuses the same write path as the dashboard PATCH endpoint. The widget_type is immutable. This edits widget settings only (config, name, description); tile placement (layouts, show_description) is a dashboard concern — use the dashboard PATCH endpoint or reorder_tiles for that. All updates succeed or fail together. To add new widgets, use the widgets/batch POST endpoint; to remove one, use delete_tile.

Parameters

required

A unique integer value identifying this dashboard.

required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Input

Widget tiles to update atomically, each identified by its tile_id. config shape is per widget_type; see dashboard-widget-catalog-list for per-type config_schema (1–10 per request).

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import posthog from '@utdk/posthog';

await posthog.dashboardsUpdateWidgetsBatch()