{ "opencollection": "1.0.0", "info": { "name": "m3ter Account Notifications API", "version": "1.0" }, "request": { "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "items": [ { "info": { "name": "Notifications", "type": "folder" }, "items": [ { "info": { "name": "List Notifications", "type": "http" }, "http": { "method": "GET", "url": "https://api.m3ter.com/organizations/:orgId/notifications/configurations", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." }, { "name": "pageSize", "value": "", "type": "query", "description": "Specifies the maximum number of Notifications to retrieve per page." }, { "name": "nextToken", "value": "", "type": "query", "description": "The `nextToken` for multi-page retrievals. It is used to fetch the next page of Notifications in a paginated list." }, { "name": "active", "value": "", "type": "query", "description": "A Boolean flag indicating whether to retrieve only active or only inactive Notifications.\n\n* **TRUE** - only active Notifications are returned. \n* **FALSE** - only inactive Notifications are returned." }, { "name": "eventName", "value": "", "type": "query", "description": "Use this to filter the Notifications returned - only those Notifications that are based on the *Event type* specified by `eventName` are returned." }, { "name": "ids", "value": "", "type": "query", "description": "A list of specific Notification UUIDs to retrieve." } ] }, "docs": "Retrieve a list of Event Notifications for the specified Organization.\n\nThis endpoint retrieves a list of all Event Notifications for the Organization identified by its UUID. The list can be paginated for easier management. The list also supports filtering by parameters such as Notification UUID. " }, { "info": { "name": "Create Notification", "type": "http" }, "http": { "method": "POST", "url": "https://api.m3ter.com/organizations/:orgId/notifications/configurations", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new Notification for an Event.\n\nThis endpoint enables you to create a new Event Notification for the specified Organization. You need to supply a request body with the details of the new Notification. \n" }, { "info": { "name": "Retrieve Notification", "type": "http" }, "http": { "method": "GET", "url": "https://api.m3ter.com/organizations/:orgId/notifications/configurations/:id", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." }, { "name": "id", "value": "", "type": "path", "description": "The unique identifier (UUID) of the Notification to retrieve." } ] }, "docs": "Retrieve the details of a specific Notification using its UUID. Includes the Event the Notification is based on, and any calculation referencing the Event's field and which defines further conditions that must be met to trigger the Notification when the Event occurs.\n" }, { "info": { "name": "Update Notification", "type": "http" }, "http": { "method": "PUT", "url": "https://api.m3ter.com/organizations/:orgId/notifications/configurations/:id", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." }, { "name": "id", "value": "", "type": "path", "description": "The unique identifier (UUID) of the Notification to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a Notification with the given UUID.\n\nThis endpoint modifies the configuration details of an existing Notification. You can change the Event that triggers the Notification and/or update the conditions for sending the Notification.\n" }, { "info": { "name": "Delete Notification", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.m3ter.com/organizations/:orgId/notifications/configurations/:id", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." }, { "name": "id", "value": "", "type": "path", "description": "The unique identifier (UUID) of the Notification to delete." } ] }, "docs": "Delete the Notification with the given UUID.\n\nThis endpoint permanently removes a specified Notification and its configuration. This action cannot be undone.\n" }, { "info": { "name": "Evaluate Calculation", "type": "http" }, "http": { "method": "POST", "url": "https://api.m3ter.com/organizations/:orgId/notifications/evaluate", "params": [ { "name": "orgId", "value": "", "type": "path", "description": "The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Evaluates a calculation against a specific Event or an Event type without triggering a Notification. This is useful for validating your calculation logic before adding it to a Notification.\n\nYou can use either the `eventId` or `eventName` to test your calculation against:\n- `eventId` Tests the calculation for validity against a *specific Event* that has been generated for your Organization.\n- `eventName` Tests the calculation for validity against the *Event type*.\n\nPossible outcomes:\n- If in eit" } ] } ], "bundled": true }