{ "info": { "_postman_id": "2534d494-1a46-4bfe-a0df-aefbf1b4241c", "name": "ThingsBoard Admin admin-controller widget-type-controller API", "description": "ThingsBoard Admin API \u2014 subset of the ThingsBoard REST API (open-source IoT platform). Covers: Admin, Audit Log, Event, Usage Info, Queue, Queue Stats, Mail Config Template, Qr Code Settings, Job.\n\nContact Support:\n Name: ThingsBoard team\n Email: info@thingsboard.io", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:13:32.000Z", "updatedAt": "2026-07-28T03:13:32.000Z", "lastUpdatedBy": "35240", "uid": "35240-2534d494-1a46-4bfe-a0df-aefbf1b4241c" }, "item": [ { "name": "api", "item": [ { "name": "widgetType", "item": [ { "name": "{widgetTypeId}", "item": [ { "name": "Get Widget Type Details (getWidgetTypeById)", "id": "c5125c17-8002-4e9a-8901-f4c37376093d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetType/:widgetTypeId?includeResources=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType", ":widgetTypeId" ], "query": [ { "description": "Export used resources and replace resource links with resource metadata", "key": "includeResources", "value": "" } ], "variable": [ { "id": "562dedf1-c26f-455b-bcfc-3a5aa665d601", "key": "widgetTypeId", "value": "", "description": "(Required) A string value representing the widget type id. For example, '784f394c-42b6-435a-983c-b7beff2784f9'" } ] }, "description": "Get the Widget Type Details based on the provided Widget Type Id. Widget Type Details extend Widget Type and add image and description properties. Those properties are useful to edit the Widget Type but they are not required for Dashboard rendering. \n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "ba4b081c-d39c-438d-9e60-3d3975f144ff", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetType/:widgetTypeId?includeResources=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType", ":widgetTypeId" ], "query": [ { "description": "Export used resources and replace resource links with resource metadata", "key": "includeResources", "value": "" } ], "variable": [ { "key": "widgetTypeId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"IMAGE\",\n \"subType\": \"IMAGE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"LWM2M_MODEL\",\n \"subType\": \"SCADA_SYMBOL\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-ba4b081c-d39c-438d-9e60-3d3975f144ff" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-c5125c17-8002-4e9a-8901-f4c37376093d" }, { "name": "Delete Widget Type (deleteWidgetType)", "id": "4d75b666-76b6-438c-a117-88764875851b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/widgetType/:widgetTypeId", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType", ":widgetTypeId" ], "variable": [ { "id": "cc83b63d-79f1-48f1-8831-d89c32b1fe1f", "key": "widgetTypeId", "value": "", "description": "(Required) A string value representing the widget type id. For example, '784f394c-42b6-435a-983c-b7beff2784f9'" } ] }, "description": "Deletes the Widget Type. Referencing non-existing Widget Type Id will cause an error.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "e29c39a7-a296-43b6-85d7-d91da2c928c8", "name": "OK", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/widgetType/:widgetTypeId", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType", ":widgetTypeId" ], "variable": [ { "key": "widgetTypeId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-e29c39a7-a296-43b6-85d7-d91da2c928c8" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-4d75b666-76b6-438c-a117-88764875851b" } ], "id": "a224cb3a-c45e-487f-990e-995735d55560", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-a224cb3a-c45e-487f-990e-995735d55560" }, { "name": "Get Widget Type (getWidgetType)", "id": "ca810dbf-b0b1-43f8-b231-9878b3e54f11", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetType?isSystem=&bundleAlias=&alias=&fqn=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType" ], "query": [ { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" }, { "description": "(Required) Widget Type alias", "key": "alias", "value": "" }, { "description": "(Required) Widget Type fqn", "key": "fqn", "value": "" } ] }, "description": "Get the Widget Type by FQN. Widget Type represents the template for widget creation. Widget Type and Widget are similar to class and object in OOP theory.\n\nAvailable for any authorized user. " }, "response": [ { "id": "14ef4f3d-9089-4c41-8f3a-6bc059663122", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetType?isSystem=&bundleAlias=&alias=&fqn=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType" ], "query": [ { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" }, { "description": "(Required) Widget Type alias", "key": "alias", "value": "" }, { "description": "(Required) Widget Type fqn", "key": "fqn", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n }\n}", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-14ef4f3d-9089-4c41-8f3a-6bc059663122" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-ca810dbf-b0b1-43f8-b231-9878b3e54f11" }, { "name": "Create or Update Widget Type (saveWidgetType)", "id": "bf30e65d-ef45-4226-af73-6bd3b4e3682d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"IMAGE\",\n \"subType\": \"IMAGE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"LWM2M_MODEL\",\n \"subType\": \"SCADA_SYMBOL\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/widgetType?updateExistingByFqn=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType" ], "query": [ { "description": "Optional boolean parameter indicating whether to update existing widget type by FQN if present instead of creating new one", "key": "updateExistingByFqn", "value": "" } ] }, "description": "Create or update the Widget Type. Widget Type represents the template for widget creation. Widget Type and Widget are similar to class and object in OOP theory. When creating the Widget Type, platform generates Widget Type Id as [time-based UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)). The newly created Widget Type Id will be present in the response. Specify existing Widget Type id to update the Widget Type. Referencing non-existing Widget Type Id will cause 'Not Found' error.\n\nWidget Type fqn is unique in the scope of System or Tenant. Special Tenant Id '13814000-1dd2-11b2-8080-808080808080' is automatically used if the create request is sent by user with 'SYS_ADMIN' authority.Remove 'id', 'tenantId' rom the request body example (below) to create new Widget Type entity.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "ae78a199-60e8-4ca2-96f7-403f0947059d", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"IMAGE\",\n \"subType\": \"IMAGE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"LWM2M_MODEL\",\n \"subType\": \"SCADA_SYMBOL\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/widgetType?updateExistingByFqn=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetType" ], "query": [ { "description": "Optional boolean parameter indicating whether to update existing widget type by FQN if present instead of creating new one", "key": "updateExistingByFqn", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"IMAGE\",\n \"subType\": \"IMAGE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"LWM2M_MODEL\",\n \"subType\": \"SCADA_SYMBOL\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-ae78a199-60e8-4ca2-96f7-403f0947059d" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-bf30e65d-ef45-4226-af73-6bd3b4e3682d" } ], "id": "06e3a3ad-292a-451e-be57-e16db0b9a99a", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-06e3a3ad-292a-451e-be57-e16db0b9a99a" }, { "name": "widgetTypes", "item": [ { "name": "Get All Widget Types for Specified Bundle (getBundleWidgetTypesByBundleAlias) (Deprecated)", "id": "eeae014a-f44b-409f-ab76-ba0bf414c5a7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypes?widgetsBundleId=&pageSize=&page=&textSearch=&sortProperty=tenantId&sortOrder=ASC, DESC&tenantOnly=&fullSearch=&deprecatedFilter=DEPRECATED&widgetTypeList=timeseries&widgetTypeList=latest&scadaFirst=&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypes" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "The case insensitive 'substring' filter based on the widget type name.", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "tenantId" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "ASC, DESC" }, { "description": "Optional boolean parameter indicating whether only tenant widget types should be returned", "key": "tenantOnly", "value": "" }, { "description": "Optional boolean parameter indicating whether search widgets by description not only by name", "key": "fullSearch", "value": "" }, { "description": "Optional string parameter indicating whether to include deprecated widgets", "key": "deprecatedFilter", "value": "DEPRECATED" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "timeseries" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "latest" }, { "description": "Optional boolean parameter indicating whether to fetch SCADA symbol widgets first", "key": "scadaFirst", "value": "" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] }, "description": "Returns an array of Widget Type objects that belong to specified Widget Bundle.Widget Type represents the template for widget creation. Widget Type and Widget are similar to class and object in OOP theory. \n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "78b3ad94-c66d-452f-aeb0-33f15f8485e4", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypes?widgetsBundleId=&pageSize=&page=&textSearch=&sortProperty=tenantId&sortOrder=ASC, DESC&tenantOnly=&fullSearch=&deprecatedFilter=DEPRECATED&widgetTypeList=latest&scadaFirst=&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypes" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "The case insensitive 'substring' filter based on the widget type name.", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "tenantId" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "ASC, DESC" }, { "description": "Optional boolean parameter indicating whether only tenant widget types should be returned", "key": "tenantOnly", "value": "" }, { "description": "Optional boolean parameter indicating whether search widgets by description not only by name", "key": "fullSearch", "value": "" }, { "description": "Optional string parameter indicating whether to include deprecated widgets", "key": "deprecatedFilter", "value": "DEPRECATED" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "latest" }, { "description": "Optional boolean parameter indicating whether to fetch SCADA symbol widgets first", "key": "scadaFirst", "value": "" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"widgetType\": \"\",\n \"bundles\": [\n {\n \"id\": {\n \"entityType\": \"API_USAGE_STATE\",\n \"id\": \"\"\n },\n \"name\": \"\"\n },\n {\n \"id\": {\n \"entityType\": \"RULE_NODE\",\n \"id\": \"\"\n },\n \"name\": \"\"\n }\n ]\n },\n {\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"widgetType\": \"\",\n \"bundles\": [\n {\n \"id\": {\n \"entityType\": \"NOTIFICATION\",\n \"id\": \"\"\n },\n \"name\": \"\"\n },\n {\n \"id\": {\n \"entityType\": \"API_KEY\",\n \"id\": \"\"\n },\n \"name\": \"\"\n }\n ]\n }\n ],\n \"totalPages\": \"\",\n \"totalElements\": \"\",\n \"hasNext\": \"\"\n}", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-78b3ad94-c66d-452f-aeb0-33f15f8485e4" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-eeae014a-f44b-409f-ab76-ba0bf414c5a7" } ], "id": "c3b5c9c7-bae0-4455-9dec-03d6edaa70f2", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-c3b5c9c7-bae0-4455-9dec-03d6edaa70f2" }, { "name": "widgetTypesInfos", "item": [ { "name": "Get Widget Type Info Objects (getBundleWidgetTypesInfosByBundleAlias) (Deprecated)", "id": "378454d9-d902-4079-a868-36b4cda3e4d6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypesInfos?widgetsBundleId=&pageSize=&page=&textSearch=&sortProperty=tenantId&sortOrder=ASC&fullSearch=&deprecatedFilter=DEPRECATED&widgetTypeList=timeseries&widgetTypeList=latest&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypesInfos" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "The case insensitive 'substring' filter based on the widget type name.", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "tenantId" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "ASC" }, { "description": "Optional boolean parameter indicating whether search widgets by description not only by name", "key": "fullSearch", "value": "" }, { "description": "Optional string parameter indicating whether to include deprecated widgets", "key": "deprecatedFilter", "value": "DEPRECATED" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "timeseries" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "latest" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] }, "description": "Get the Widget Type Info objects based on the provided parameters. Widget Type Info is a lightweight object that represents Widget Type but does not contain the heavyweight widget descriptor JSON\n\nAvailable for any authorized user. " }, "response": [ { "id": "7605feea-ad18-4190-b139-a7fcd34cd895", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypesInfos?widgetsBundleId=&pageSize=&page=&textSearch=&sortProperty=tenantId&sortOrder=ASC&fullSearch=&deprecatedFilter=DEPRECATED&widgetTypeList=latest&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypesInfos" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "The case insensitive 'substring' filter based on the widget type name.", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "tenantId" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "ASC" }, { "description": "Optional boolean parameter indicating whether search widgets by description not only by name", "key": "fullSearch", "value": "" }, { "description": "Optional string parameter indicating whether to include deprecated widgets", "key": "deprecatedFilter", "value": "DEPRECATED" }, { "description": "A list of string values separated by comma ',' representing one of the widget type value", "key": "widgetTypeList", "value": "latest" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"widgetType\": \"\",\n \"bundles\": [\n {\n \"id\": {\n \"entityType\": \"NOTIFICATION\",\n \"id\": \"\"\n },\n \"name\": \"\"\n },\n {\n \"id\": {\n \"entityType\": \"MOBILE_APP\",\n \"id\": \"\"\n },\n \"name\": \"\"\n }\n ]\n },\n {\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"widgetType\": \"\",\n \"bundles\": [\n {\n \"id\": {\n \"entityType\": \"NOTIFICATION_TARGET\",\n \"id\": \"\"\n },\n \"name\": \"\"\n },\n {\n \"id\": {\n \"entityType\": \"EDGE\",\n \"id\": \"\"\n },\n \"name\": \"\"\n }\n ]\n }\n]", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-7605feea-ad18-4190-b139-a7fcd34cd895" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-378454d9-d902-4079-a868-36b4cda3e4d6" } ], "id": "60d2f70e-8326-4313-a4cf-3f1c56b9ed60", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-60d2f70e-8326-4313-a4cf-3f1c56b9ed60" }, { "name": "widgetTypesDetails", "item": [ { "name": "Get All Widget Types Details for Specified Bundle (getBundleWidgetTypesDetailsByBundleAlias) (Deprecated)", "id": "70eb075f-8078-4e83-8fe4-ea26162e248f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypesDetails?widgetsBundleId=&includeResources=&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypesDetails" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "Export used resources and replace resource links with resource metadata", "key": "includeResources", "value": "" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] }, "description": "Returns an array of Widget Type Details objects that belong to specified Widget Bundle.Widget Type Details extend Widget Type and add image and description properties. Those properties are useful to edit the Widget Type but they are not required for Dashboard rendering. \n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "39793d2c-35a0-422e-8fdc-7b39730fe3f8", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypesDetails?widgetsBundleId=&includeResources=&isSystem=&bundleAlias=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypesDetails" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" }, { "description": "Export used resources and replace resource links with resource metadata", "key": "includeResources", "value": "" }, { "description": "(Required) System or Tenant", "key": "isSystem", "value": "" }, { "description": "(Required) Widget Bundle alias", "key": "bundleAlias", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"IMAGE\",\n \"subType\": \"MODULE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"GENERAL\",\n \"subType\": \"SCADA_SYMBOL\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n },\n {\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"descriptor\": {\n \"description\": \"A value representing the any type (object or primitive)\",\n \"examples\": [\n {}\n ]\n },\n \"resources\": [\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"JS_MODULE\",\n \"subType\": \"MODULE\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n },\n {\n \"link\": \"\",\n \"title\": \"\",\n \"type\": \"DASHBOARD\",\n \"subType\": \"EXTENSION\",\n \"resourceKey\": \"\",\n \"fileName\": \"\",\n \"publicResourceKey\": \"\",\n \"isPublic\": \"\",\n \"mediaType\": \"\",\n \"data\": \"\",\n \"public\": \"\"\n }\n ],\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"scada\": \"\",\n \"version\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n }\n]", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-39793d2c-35a0-422e-8fdc-7b39730fe3f8" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-70eb075f-8078-4e83-8fe4-ea26162e248f" } ], "id": "1b7a9c22-236e-4fcb-9992-786295b7ed9d", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-1b7a9c22-236e-4fcb-9992-786295b7ed9d" }, { "name": "widgetTypeInfo", "item": [ { "name": "{widgetTypeId}", "item": [ { "name": "Get Widget Type Info (getWidgetTypeInfoById)", "id": "0d9395db-0b91-4912-8fc7-942129166c86", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypeInfo/:widgetTypeId", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypeInfo", ":widgetTypeId" ], "variable": [ { "id": "468fb9ab-ec21-4ec7-bcf3-07c3f6bc189e", "key": "widgetTypeId", "value": "", "description": "(Required) A string value representing the widget type id. For example, '784f394c-42b6-435a-983c-b7beff2784f9'" } ] }, "description": "Get the Widget Type Info based on the provided Widget Type Id. Widget Type Details extend Widget Type and add image and description properties. Those properties are useful to edit the Widget Type but they are not required for Dashboard rendering. \n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "407e886d-8a34-4533-8df1-15fd2874040e", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypeInfo/:widgetTypeId", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypeInfo", ":widgetTypeId" ], "variable": [ { "key": "widgetTypeId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": {\n \"entityType\": \"WIDGET_TYPE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"fqn\": \"\",\n \"name\": \"\",\n \"deprecated\": \"\",\n \"scada\": \"\",\n \"version\": \"\",\n \"image\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"widgetType\": \"\",\n \"bundles\": [\n {\n \"id\": {\n \"entityType\": \"RULE_CHAIN\",\n \"id\": \"\"\n },\n \"name\": \"\"\n },\n {\n \"id\": {\n \"entityType\": \"NOTIFICATION\",\n \"id\": \"\"\n },\n \"name\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-407e886d-8a34-4533-8df1-15fd2874040e" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-0d9395db-0b91-4912-8fc7-942129166c86" } ], "id": "78d5a267-daa4-472f-aaa7-900b8d9391fe", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-78d5a267-daa4-472f-aaa7-900b8d9391fe" } ], "id": "6828f5ba-92d5-48ad-88bb-7f64ae85482d", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-6828f5ba-92d5-48ad-88bb-7f64ae85482d" }, { "name": "widgetTypeFqns", "item": [ { "name": "Get All Widget Type Fqns for Specified Bundle (getBundleWidgetTypeFqns)", "id": "7719419f-dc4a-4464-a2b9-a76ef2e41d25", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypeFqns?widgetsBundleId=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypeFqns" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" } ] }, "description": "Returns an array of Widget Type fqns that belong to specified Widget Bundle.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "f9b3d3bb-a6c5-409e-b9c2-c0061360c382", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/widgetTypeFqns?widgetsBundleId=", "host": [ "{{baseUrl}}" ], "path": [ "api", "widgetTypeFqns" ], "query": [ { "description": "(Required) Widget Bundle Id", "key": "widgetsBundleId", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n \"\",\n \"\"\n]", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-f9b3d3bb-a6c5-409e-b9c2-c0061360c382" } ], "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-7719419f-dc4a-4464-a2b9-a76ef2e41d25" } ], "id": "5bcbe92a-c7aa-40da-abf2-ce98a962b045", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-5bcbe92a-c7aa-40da-abf2-ce98a962b045" } ], "id": "d1208431-7ef6-4d49-b077-a16de9f7956d", "createdAt": "2026-07-28T03:13:33.000Z", "updatedAt": "2026-07-28T03:13:33.000Z", "uid": "35240-d1208431-7ef6-4d49-b077-a16de9f7956d" } ], "variable": [ { "key": "baseUrl", "value": "https://demo.thingsboard.io" } ] }