{ "opencollection": "1.0.0", "info": { "name": "ThingsBoard Admin admin-controller notification-target-controller API", "version": "4.3.0.3DEMO" }, "items": [ { "info": { "name": "notification-target-controller", "type": "folder" }, "items": [ { "info": { "name": "Save Notification Target (saveNotificationTarget)", "type": "http" }, "http": { "method": "POST", "url": "https://demo.thingsboard.io/api/notification/target", "body": { "type": "json", "data": "{}" } }, "docs": "Creates or updates notification target.\n\nAvailable `configuration` types are `PLATFORM_USERS` and `SLACK`.\nFor `PLATFORM_USERS` the `usersFilter` must be specified. For tenant, there are following users filter types available: `USER_LIST`, `CUSTOMER_USERS`, `TENANT_ADMINISTRATORS`, `ALL_USERS`, `ORIGINATOR_ENTITY_OWNER_USERS`, `AFFECTED_USER`.\nFor sysadmin: `TENANT_ADMINISTRATORS`, `AFFECTED_TENANT_ADMINISTRATORS`, `SYSTEM_ADMINISTRATORS`, `ALL_USERS`.\n\nHere is an example of tenant-level notific" }, { "info": { "name": "Get Recipients for Notification Target Config (getRecipientsForNotificationTargetConfig)", "type": "http" }, "http": { "method": "POST", "url": "https://demo.thingsboard.io/api/notification/target/recipients", "params": [ { "name": "pageSize", "value": "", "type": "query", "description": "Maximum amount of entities in a one page" }, { "name": "page", "value": "", "type": "query", "description": "Sequence number of page starting from 0" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Returns the page of recipients for such notification target configuration.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, { "info": { "name": "Get Notification Targets by Ids (getNotificationTargetsByIds)", "type": "http" }, "http": { "method": "GET", "url": "https://demo.thingsboard.io/api/notification/targets", "params": [ { "name": "pageSize", "value": "", "type": "query", "description": "Maximum amount of entities in a one page" }, { "name": "page", "value": "", "type": "query", "description": "Sequence number of page starting from 0" }, { "name": "textSearch", "value": "", "type": "query", "description": "Case-insensitive 'substring' filed based on the target's name" }, { "name": "sortProperty", "value": "", "type": "query", "description": "Property of entity to sort by" }, { "name": "sortOrder", "value": "", "type": "query", "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)" }, { "name": "notificationType", "value": "", "type": "query" }, { "name": "ids", "value": "", "type": "query", "description": "Comma-separated list of uuids representing targets ids" } ] }, "docs": "Returns the list of notification targets found by provided ids.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, { "info": { "name": "Get Notification Target by Id (getNotificationTargetById)", "type": "http" }, "http": { "method": "GET", "url": "https://demo.thingsboard.io/api/notification/target/:id", "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Fetches notification target by id.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, { "info": { "name": "Delete Notification Target by Id (deleteNotificationTargetById)", "type": "http" }, "http": { "method": "DELETE", "url": "https://demo.thingsboard.io/api/notification/target/:id", "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Deletes notification target by its id.\n\nThis target cannot be referenced by existing scheduled notification requests or any notification rules.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." } ] } ], "bundled": true }