Widgets

These endpoints let you manage widgets in the system. It allows you to retrieve, create, update, and delete widget records.

Get Widgets by Current User

get

Search Query

Supported Keys	Supported Operators	Notes
widgetType	:	Equal operator

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/users/me/widgets

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/users/me/widgets" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "ff6ba12f-adc2-4d9e-910c-9a9a91b062b9",
      "position": 5,
      "widgetType": "CHART",
      "content": {
        "id": "1",
        "title": "Chart",
        "size": 2
      }
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 1,
  "totalElements": 1,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}