feat: Notehub API updates—sat data, firmware sorting, small stuff

openapi.filtered.yaml

@@ -153,13 +153,12 @@ paths:
           $ref: "#/components/responses/GetDeviceEnvironmentVariablesResponse"
         default:
           $ref: "#/components/responses/ErrorResponse"
-      security:
-        - pin: []
       tags:
         - device
     parameters:
       - $ref: "#/components/parameters/productUIDParam"
       - $ref: "#/components/parameters/deviceUIDParam"
+      - $ref: "#/components/parameters/XAuthTokenHeader"
     put:
       operationId: SetDeviceEnvironmentVariablesByPin
       description: Set environment variables of a device with device pin authorization
@@ -175,8 +174,6 @@ paths:
           $ref: "#/components/responses/EnvironmentVariablesResponse"
         default:
           $ref: "#/components/responses/ErrorResponse"
-      security:
-        - pin: []
       tags:
         - device
   /v1/products/{productUID}/ext-devices/{deviceUID}/event:
@@ -461,13 +458,6 @@ paths:
     delete:
       operationId: DeleteDevice
       description: Delete Device
-      parameters:
-        - name: purge
-          in: query
-          required: true
-          schema:
-            type: boolean
-            default: false
       responses:
         "204":
           description: Successful operation
@@ -1518,6 +1508,8 @@ paths:
         - $ref: "#/components/parameters/filenameQueryParam"
         - $ref: "#/components/parameters/md5QueryParam"
         - $ref: "#/components/parameters/unpublishedQueryParam"
+        - $ref: "#/components/parameters/firmwareSortByParam"
+        - $ref: "#/components/parameters/firmwareSortOrderParam"
       responses:
         "200":
           description: Success
@@ -2380,6 +2372,8 @@ paths:
         - $ref: "#/components/parameters/systemFilesOnlyParam"
         - $ref: "#/components/parameters/mostRecentOnlyParam"
         - $ref: "#/components/parameters/filesQueryParam"
+        - $ref: "#/components/parameters/routingStatusParam"
+        - $ref: "#/components/parameters/responseStatusParam"
       responses:
         "200":
           description: Successful operation
@@ -2558,6 +2552,16 @@ paths:
             enum:
               - route
               - project
+        - name: skipRecentData
+          in: query
+          description:
+            When true, skips fetching recent data from raw event tables and
+            only returns data from summary tables. Use this for better
+            performance on large projects.
+          required: false
+          schema:
+            type: boolean
+            default: false
       responses:
         "200":
           $ref: "#/components/responses/UsageRouteLogsResponse"
@@ -2936,6 +2940,30 @@ components:
       required: false
       schema:
         type: string
+    firmwareSortByParam:
+      description: Field to sort by
+      in: query
+      name: sortBy
+      required: false
+      schema:
+        type: string
+        default: created
+        enum:
+          - created
+          - name
+          - version
+          - length
+    firmwareSortOrderParam:
+      description: Sort order (asc for ascending, desc for descending)
+      in: query
+      name: sortOrder
+      required: false
+      schema:
+        type: string
+        default: desc
+        enum:
+          - asc
+          - desc
     firmwareTypeParam:
       in: path
       name: firmwareType
@@ -3142,6 +3170,15 @@ components:
       schema:
         type: string
         example: rid:2606f411-dea6-44a0-9743-1130f57d77d8
+    responseStatusParam:
+      example: 500
+      in: query
+      name: responseStatus
+      required: false
+      schema:
+        type: array
+        items:
+          type: string
     routeLogsSortByParam:
       in: query
       name: sortBy
@@ -3180,6 +3217,18 @@ components:
         items:
           type: string
       style: form
+    routingStatusParam:
+      example: failure
+      in: query
+      name: routingStatus
+      required: false
+      schema:
+        type: array
+        items:
+          enum:
+            - success
+            - failure
+          type: string
     selectFieldsParam:
       description:
         Comma-separated list of fields to select from JSON payload (e.g.,
@@ -3313,6 +3362,13 @@ components:
       schema:
         type: string
         example: Abc_123-2646f411-dc56-44a0-9743-4130f47a74h8
+    XAuthTokenHeader:
+      description: For accessing endpoints by Device pin.
+      in: header
+      name: X-Auth-Token
+      required: true
+      schema:
+        type: string
   schemas:
     Alert:
       type: object
@@ -3344,6 +3400,7 @@ components:
                 type: string
                 enum:
                   - event
+                  - device
               source_uid:
                 description: The UID of the source of the alert
                 type: string
@@ -3575,8 +3632,9 @@ components:
         - required:
             - name
             - description
-            - notefile_filter
             - alert_routes
+            - source_type
+            - threshold
     CreateUpdateRepository:
       type: object
       properties:
@@ -4757,10 +4815,13 @@ components:
           type: string
           example: body.temperature
         source_type:
-          description: The type of source to monitor. Currently only "event" is supported.
+          description:
+            The type of source to monitor. Supported values are "event" and
+            "heartbeat".
           type: string
           enum:
             - event
+            - heartbeat
         threshold:
           description:
             The type of condition to apply to the value selected by the
@@ -5284,6 +5345,34 @@ components:
           type: string
           format: uri
       additionalProperties: false
+    SatelliteDataUsage:
+      type: object
+      properties:
+        bytes_remaining:
+          description: Bytes remaining in the plan
+          type: integer
+          format: int64
+          example: 18600
+        bytes_total:
+          description: Total bytes included in the plan
+          type: integer
+          format: int64
+          example: 18650
+        bytes_used:
+          description: Bytes used to date
+          type: integer
+          format: int64
+          example: 49
+        bytes_used_billable:
+          description: Billable bytes used to date
+          type: integer
+          format: int64
+          example: 50
+      required:
+        - bytes_total
+        - bytes_used
+        - bytes_used_billable
+        - bytes_remaining
     SatellitePlan:
       type: object
       properties:
@@ -5292,13 +5381,16 @@ components:
           type: integer
           format: int64
           example: 1609459200
-        billable_bytes:
-          $ref: "#/components/schemas/DataUsage"
-        last_updated:
-          description: Time this plan information was last updated
+        last_session_at:
+          description: When this Starnote last had a session
           type: integer
           format: int64
-          example: 1656010061
+          example: 1808675309
+        minimum_billable_bytes:
+          description: Minimum billable bytes
+          type: integer
+          format: int64
+          example: 50
         ntn_provider:
           description: Non-Terrestrial Network provider name
           type: string
@@ -5307,6 +5399,8 @@ components:
           description: Provider-specific identifier for the satellite subscription
           type: string
           example: skylo:5746354465786
+        satellite_data_usage:
+          $ref: "#/components/schemas/SatelliteDataUsage"
       nullable: true
       required:
         - ntn_provider
@@ -5608,6 +5702,18 @@ components:
     UsageData:
       type: object
       properties:
+        billable_bytes_received:
+          description: Billable bytes received (only for packet-based protocols)
+          type: integer
+          format: int64
+        billable_bytes_sent:
+          description: Billable bytes sent (only for packet-based protocols)
+          type: integer
+          format: int64
+        billable_bytes_total:
+          description: Total billable bytes (only for packet-based protocols)
+          type: integer
+          format: int64
         bytes_received:
           type: integer
           format: int64
@@ -5616,6 +5722,14 @@ components:
           type: integer
           format: int64
           example: 524288
+        packets_received:
+          description: Packets received (only for packet-based protocols)
+          type: integer
+          format: int64
+        packets_sent:
+          description: Packets sent (only for packet-based protocols)
+          type: integer
+          format: int64
         period:
           type: string
           format: date-time
@@ -6227,6 +6341,9 @@ components:
                         aggregate is 'device')
                       type: string
                       example: dev:123456789012345
+                    device_count:
+                      description: the number of devices represented by this data point
+                      type: integer
                     fleet:
                       description:
                         The fleet UID this usage data belongs to (only present when
@@ -6239,12 +6356,12 @@ components:
                         'cellular')
                       type: string
                       example: "12345678901234567890"
-                    imsi:
+                    psid:
                       description:
-                        The IMSI of the satellite device (only present when type is
-                        'satellite')
+                        The PSID (Packet Service ID) of the satellite (or other
+                        packet-based device)
                       type: string
-                      example: "123456789012345"
+                      example: skylo:5746354465786
                     type:
                       description: The type of connectivity
                       type: string
@@ -6287,12 +6404,6 @@ components:
         Use a personal access token from notehub.io/api-access
       scheme: bearer
       type: http
-    pin:
-      description: |
-        For accessing endpoints by Device pin.
-      in: header
-      name: X-Auth-Token
-      type: apiKey
 tags:
   - description: Authorization operations
     name: authorization