Skip to Content
BlitzPulse docs are live. Looking for the app? Visit https://app.blitzglobalcapital.com.
Api ReferenceWidgets API

Widgets API

Auto-generated from openapi-snapshot.json. Do not edit by hand — changes are overwritten by scripts/docs/generate_api_reference.py.

5 endpoints in this group.

GET /api/v1/widgets/visibility

List Visibility

List the current user effective widget visibility rows.

Returns only rows the user has explicitly set. Callers merge registry defaults client-side (see _defaultRow in blitzpulse-web/src/hooks/useWidgetVisibility.ts).

Responses

CodeDescription
200Successful Response

DELETE /api/v1/widgets/visibility/{widget_id}

Delete Visibility

Drop the user override for widget_id; reverts to registry defaults.

Parameters

NameInTypeRequiredDescription
widget_idpathstringrequired

Responses

CodeDescription
204Successful Response
422Validation Error

PUT /api/v1/widgets/visibility/{widget_id}

Upsert Visibility

Upsert the user visibility row for widget_id (partial update).

Parameters

NameInTypeRequiredDescription
widget_idpathstringrequired

Request body: application/json

Responses

CodeDescription
200Successful Response
422Validation Error

PATCH /api/v1/widgets/visibility/{widget_id}/collapsed

Patch Collapsed

Shortcut PATCH for the frontend widgetsApi.setCollapsed client.

Parameters

NameInTypeRequiredDescription
widget_idpathstringrequired

Request body: application/json

Responses

CodeDescription
200Successful Response
422Validation Error

PATCH /api/v1/widgets/visibility/{widget_id}/position

Patch Position

Shortcut PATCH for the frontend widgetsApi.setPosition client.

Parameters

NameInTypeRequiredDescription
widget_idpathstringrequired

Request body: application/json

Responses

CodeDescription
200Successful Response
422Validation Error