Widgets API
Auto-generated from
openapi-snapshot.json. Do not edit by hand — changes are overwritten byscripts/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
| Code | Description |
|---|---|
200 | Successful Response |
DELETE /api/v1/widgets/visibility/{widget_id}
Delete Visibility
Drop the user override for widget_id; reverts to registry defaults.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
widget_id | path | string | required |
Responses
| Code | Description |
|---|---|
204 | Successful Response |
422 | Validation Error |
PUT /api/v1/widgets/visibility/{widget_id}
Upsert Visibility
Upsert the user visibility row for widget_id (partial update).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
widget_id | path | string | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /api/v1/widgets/visibility/{widget_id}/collapsed
Patch Collapsed
Shortcut PATCH for the frontend widgetsApi.setCollapsed client.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
widget_id | path | string | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /api/v1/widgets/visibility/{widget_id}/position
Patch Position
Shortcut PATCH for the frontend widgetsApi.setPosition client.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
widget_id | path | string | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |