{
  "openapi": "3.1.0",
  "info": {
    "title": "Breeze Push",
    "version": "0.1.0",
    "description": "Accountless client-owned webhooks. Apple framework tokens have separate capabilities and gates. Android FID delivery is implemented and gated per deployment by FCM configuration; query /v1/capabilities for current availability. This document does not assert that either hosted environment has Android enabled or end-to-end verified."
  },
  "servers": [
    {
      "url": "https://push.breezelabs.dev",
      "description": "Production: production APNs; Android uses this deployment Firebase project only when enabled."
    },
    {
      "url": "https://push-stg.breezelabs.dev",
      "description": "Staging: sandbox APNs; Android uses its separate configured Firebase project only when enabled."
    }
  ],
  "paths": {
    "/ping": {
      "get": {
        "summary": "ping",
        "operationId": "get_ping",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/healthz": {
      "get": {
        "summary": "healthz",
        "operationId": "get_healthz",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/info": {
      "get": {
        "summary": "info",
        "operationId": "get_info",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/capabilities": {
      "get": {
        "summary": "v1/capabilities",
        "operationId": "get_v1_capabilities",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/readyz": {
      "get": {
        "summary": "Check storage and the selected provider authentication",
        "operationId": "get_readyz",
        "parameters": [
          {
            "in": "query",
            "name": "provider",
            "schema": {
              "type": "string",
              "enum": [
                "apns",
                "fcm"
              ],
              "default": "apns"
            },
            "description": "FCM readiness is independent of APNs credentials and gated by this deployment configuration."
          },
          {
            "in": "query",
            "name": "environment",
            "schema": {
              "type": "string",
              "enum": [
                "sandbox",
                "production"
              ]
            },
            "description": "APNs only: defaults to the deployment APNs environment. FCM rejects this parameter; its Firebase project is server-selected. The other APNs environment is unavailable on isolated servers."
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "Defaults to APNs, preserving the iOS readiness contract. FCM checks D1 and OAuth credentials without sending a notification. A ready response does not prove end-to-end phone delivery."
      }
    },
    "/v1/devices": {
      "post": {
        "summary": "Register or reconnect an APNs or Android FID installation",
        "operationId": "post_v1_devices",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeviceRegistration"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "Android requires FCM enabled and configured in this deployment, a matching app_id, and successful provider authentication. Disabled FCM returns 422 provider_not_enabled; app_id mismatch returns 422 app_mismatch. No device is stored when provider setup fails."
      }
    },
    "/v1/devices/{id}": {
      "put": {
        "summary": "Refresh the provider address using installation management authorization",
        "operationId": "put_v1_devices__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeviceRefresh"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Revoke the installation and all its webhooks",
        "operationId": "delete_v1_devices__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/devices/{id}/rotate": {
      "post": {
        "summary": "Immediately replace the device webhook secret",
        "operationId": "post_v1_devices__id__rotate",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Rotate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/channels": {
      "post": {
        "summary": "Create a client-owned shared-device webhook",
        "operationId": "post_v1_channels",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChannelRegistration"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/channels/{id}": {
      "delete": {
        "summary": "Revoke a shared-device webhook",
        "operationId": "delete_v1_channels__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/channels/{id}/rotate": {
      "post": {
        "summary": "Replace a shared-device webhook secret",
        "operationId": "post_v1_channels__id__rotate",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Rotate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/channels/{id}/devices/{deviceId}": {
      "put": {
        "summary": "Attach a device after proving both ownership identities",
        "operationId": "put_v1_channels__id__devices__deviceId_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "in": "path",
            "name": "deviceId",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Attach"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Detach a shared-device member",
        "operationId": "delete_v1_channels__id__devices__deviceId_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "in": "path",
            "name": "deviceId",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/devices/{id}/targets": {
      "post": {
        "summary": "Enroll a dedicated Apple framework token",
        "operationId": "post_v1_devices__id__targets",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TargetRegistration"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "Apple installations only. Requires an enabled push type. VoIP, PTT, Location, FileProvider, complication, MDM, and accessory also require the operator X-Provider-Admin secret. Topics are never client-supplied."
      }
    },
    "/v1/devices/{id}/targets/{targetId}": {
      "delete": {
        "summary": "Revoke a specialized token webhook",
        "operationId": "delete_v1_devices__id__targets__targetId_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "in": "path",
            "name": "targetId",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {
            "ManagementAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        }
      }
    },
    "/v1/send": {
      "post": {
        "summary": "Send a plain-text or JSON notification",
        "operationId": "post_v1_send",
        "parameters": [],
        "security": [
          {
            "WebhookAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "207": {
            "description": "Partial acceptance. data follows DeliverySummary. Preserve accepted results; do not blindly retry the entire batch, especially when data.outcome_unknown=true.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "422": {
            "description": "A target or provider does not support the requested push type or field. Android ordinary background synchronization, badge, ciphertext and custom sound are unsupported.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "429": {
            "description": "Breeze rate limit; honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "502": {
            "description": "Provider rejection or unknown result. outcome_unknown=true means delivery may already have succeeded and retryable=false; never automatically resend.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "503": {
            "description": "Provider configuration, authentication, or temporary availability failure. Only retry when retryable=true and honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "The registered target selects the provider; senders cannot override address, project, package or credentials. Push documents the provider field union; Android requests must also satisfy AndroidPush. Mixed batches must use the intersection of supported fields and should omit provider-specific priority. All targets are validated before any delivery.",
        "requestBody": {
          "required": true,
          "content": {
            "text/plain": {
              "schema": {
                "type": "string",
                "maxLength": 16384
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            }
          }
        }
      }
    },
    "/v1/{key}": {
      "post": {
        "summary": "Send a plain-text or JSON notification",
        "operationId": "post_v1__key_",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 27,
              "maxLength": 27,
              "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
              "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "207": {
            "description": "Partial acceptance. data follows DeliverySummary. Preserve accepted results; do not blindly retry the entire batch, especially when data.outcome_unknown=true.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "422": {
            "description": "A target or provider does not support the requested push type or field. Android ordinary background synchronization, badge, ciphertext and custom sound are unsupported.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "429": {
            "description": "Breeze rate limit; honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "502": {
            "description": "Provider rejection or unknown result. outcome_unknown=true means delivery may already have succeeded and retryable=false; never automatically resend.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "503": {
            "description": "Provider configuration, authentication, or temporary availability failure. Only retry when retryable=true and honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "The registered target selects the provider; senders cannot override address, project, package or credentials. Push documents the provider field union; Android requests must also satisfy AndroidPush. Mixed batches must use the intersection of supported fields and should omit provider-specific priority. All targets are validated before any delivery.",
        "requestBody": {
          "required": true,
          "content": {
            "text/plain": {
              "schema": {
                "type": "string",
                "maxLength": 16384
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            }
          }
        }
      },
      "get": {
        "summary": "Send a quick notification using query parameters",
        "operationId": "get_v1__key_",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 27,
              "maxLength": 27,
              "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
              "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
            }
          },
          {
            "in": "query",
            "name": "message",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "title",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "Uses the same provider constraints as POST. Android visible alerts or explicit delete=1 with id only; no ordinary background synchronization."
      }
    },
    "/push": {
      "post": {
        "summary": "Send a plain-text or JSON notification",
        "operationId": "post_push",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "207": {
            "description": "Partial acceptance. data follows DeliverySummary. Preserve accepted results; do not blindly retry the entire batch, especially when data.outcome_unknown=true.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "422": {
            "description": "A target or provider does not support the requested push type or field. Android ordinary background synchronization, badge, ciphertext and custom sound are unsupported.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "429": {
            "description": "Breeze rate limit; honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "502": {
            "description": "Provider rejection or unknown result. outcome_unknown=true means delivery may already have succeeded and retryable=false; never automatically resend.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "503": {
            "description": "Provider configuration, authentication, or temporary availability failure. Only retry when retryable=true and honor Retry-After.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          },
          "default": {
            "description": "JSON response with code, message/error, request_id, optional retryable/outcome_unknown, and endpoint data. Acceptance means provider acceptance, not terminal display.",
            "headers": {
              "Retry-After": {
                "description": "Retry delay in seconds, or an HTTP date where returned by an upstream provider. Honor this delay for a retryable failure. It never authorizes replay when outcome_unknown=true; accepted or mixed batches must not be blindly replayed.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response"
                }
              }
            }
          }
        },
        "description": "The registered target selects the provider; senders cannot override address, project, package or credentials. Push documents the provider field union; Android requests must also satisfy AndroidPush. Mixed batches must use the intersection of supported fields and should omit provider-specific priority. All targets are validated before any delivery.",
        "requestBody": {
          "required": true,
          "content": {
            "text/plain": {
              "schema": {
                "type": "string",
                "maxLength": 16384
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Push"
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "WebhookAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Send-only webhook secret."
      },
      "ManagementAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Private device/channel management secret. Never expose to notification senders."
      }
    },
    "schemas": {
      "Response": {
        "type": "object",
        "required": [
          "code",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "integer"
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          },
          "message": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "retryable": {
            "type": "boolean"
          },
          "outcome_unknown": {
            "type": "boolean",
            "description": "A provider may have accepted the notification before the response was lost. When true, retryable must be false: do not automatically resend."
          },
          "data": {
            "description": "Endpoint-specific result. Send and partial-send data use DeliverySummary; registration/readiness/discovery have their own fields."
          }
        },
        "allOf": [
          {
            "if": {
              "required": [
                "outcome_unknown"
              ],
              "properties": {
                "outcome_unknown": {
                  "const": true
                }
              }
            },
            "then": {
              "required": [
                "retryable"
              ],
              "properties": {
                "retryable": {
                  "const": false
                }
              }
            }
          }
        ]
      },
      "DeliverySummary": {
        "type": "object",
        "properties": {
          "accepted": {
            "type": "integer",
            "minimum": 0
          },
          "failed": {
            "type": "integer",
            "minimum": 0
          },
          "unavailable_webhooks": {
            "type": "integer",
            "minimum": 0
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "retryable": {
            "type": "boolean"
          },
          "outcome_unknown": {
            "type": "boolean",
            "description": "At least one result is unknown. Keep accepted results and do not replay the entire batch."
          },
          "retry_after_seconds": {
            "type": "integer",
            "minimum": 0,
            "description": "Provider retry delay for known retryable failures, never permission to replay unknown or accepted results."
          }
        },
        "allOf": [
          {
            "if": {
              "required": [
                "outcome_unknown"
              ],
              "properties": {
                "outcome_unknown": {
                  "const": true
                }
              }
            },
            "then": {
              "required": [
                "retryable"
              ],
              "properties": {
                "retryable": {
                  "const": false
                }
              }
            }
          }
        ]
      },
      "DeviceRegistration": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/APNSDeviceRegistration"
          },
          {
            "$ref": "#/components/schemas/AndroidDeviceRegistration"
          }
        ],
        "discriminator": {
          "propertyName": "platform",
          "mapping": {
            "ios": "#/components/schemas/APNSDeviceRegistration",
            "watchos": "#/components/schemas/APNSDeviceRegistration",
            "android": "#/components/schemas/AndroidDeviceRegistration"
          }
        },
        "description": "Client-owned provider registration. Android never uses an APNs environment or a caller-selected Firebase project. Generated clients must send platform explicitly. For historical Apple requests the server still defaults omitted platform to ios."
      },
      "APNSDeviceRegistration": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "platform",
          "installation_id",
          "management_secret",
          "key",
          "device_token",
          "environment"
        ],
        "properties": {
          "installation_id": {
            "type": "string",
            "minLength": 16,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "management_secret": {
            "type": "string",
            "minLength": 32,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Client-generated CSPRNG secret; use at least 32 random bytes before encoding."
          },
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_d_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "platform": {
            "type": "string",
            "enum": [
              "ios",
              "watchos"
            ],
            "default": "ios"
          },
          "device_token": {
            "type": "string",
            "pattern": "^(?:[A-Fa-f0-9]{2}){1,2048}$"
          },
          "environment": {
            "type": "string",
            "enum": [
              "sandbox",
              "production"
            ]
          }
        }
      },
      "AndroidDeviceRegistration": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "platform",
          "installation_id",
          "management_secret",
          "key",
          "address_kind",
          "fid",
          "app_id"
        ],
        "description": "Canonical FID-only Android contract. APNs fields, legacy address kinds, project/package routing overrides and server credentials are forbidden.",
        "properties": {
          "installation_id": {
            "type": "string",
            "minLength": 16,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "management_secret": {
            "type": "string",
            "minLength": 32,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Client-generated CSPRNG secret; use at least 32 random bytes before encoding."
          },
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_d_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "platform": {
            "type": "string",
            "const": "android"
          },
          "address_kind": {
            "type": "string",
            "const": "fcm_installation_id"
          },
          "fid": {
            "type": "string",
            "minLength": 22,
            "maxLength": 22,
            "pattern": "^[A-Za-z0-9_-]{22}$",
            "description": "Actual case-sensitive Firebase Installation ID from FirebaseMessagingService.onRegistered after successful FCM registration; not a legacy registration token or Firebase App ID."
          },
          "app_id": {
            "type": "string",
            "maxLength": 255,
            "pattern": "^[A-Za-z][A-Za-z0-9_]*(?:\\.[A-Za-z][A-Za-z0-9_]*)+$",
            "examples": [
              "com.hiromoto.breezepush",
              "com.hiromoto.breezepush.stg"
            ],
            "description": "Android package/applicationId. Must match this deployment FCM_ANDROID_PACKAGE or registration returns 422 app_mismatch. This guard is not authentication and is not the Firebase App ID (1:...:android:...). The server chooses the Firebase project."
          }
        }
      },
      "DeviceRefresh": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/APNSDeviceRefresh"
          },
          {
            "$ref": "#/components/schemas/AndroidDeviceRefresh"
          }
        ],
        "discriminator": {
          "propertyName": "platform",
          "mapping": {
            "ios": "#/components/schemas/APNSDeviceRefresh",
            "watchos": "#/components/schemas/APNSDeviceRefresh",
            "android": "#/components/schemas/AndroidDeviceRefresh"
          }
        },
        "description": "Management identity comes only from the URL and Bearer header. Refresh cannot move an installation to another platform. Generated clients must send platform explicitly. For historical Apple requests the server still defaults omitted platform to ios."
      },
      "APNSDeviceRefresh": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "platform",
          "key",
          "device_token",
          "environment"
        ],
        "properties": {
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_d_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "platform": {
            "type": "string",
            "enum": [
              "ios",
              "watchos"
            ],
            "default": "ios"
          },
          "device_token": {
            "type": "string",
            "pattern": "^(?:[A-Fa-f0-9]{2}){1,2048}$"
          },
          "environment": {
            "type": "string",
            "enum": [
              "sandbox",
              "production"
            ]
          }
        }
      },
      "AndroidDeviceRefresh": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "platform",
          "key",
          "address_kind",
          "fid",
          "app_id"
        ],
        "properties": {
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_d_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "platform": {
            "type": "string",
            "const": "android"
          },
          "address_kind": {
            "type": "string",
            "const": "fcm_installation_id"
          },
          "fid": {
            "type": "string",
            "minLength": 22,
            "maxLength": 22,
            "pattern": "^[A-Za-z0-9_-]{22}$",
            "description": "Actual case-sensitive Firebase Installation ID from FirebaseMessagingService.onRegistered after successful FCM registration; not a legacy registration token or Firebase App ID."
          },
          "app_id": {
            "type": "string",
            "maxLength": 255,
            "pattern": "^[A-Za-z][A-Za-z0-9_]*(?:\\.[A-Za-z][A-Za-z0-9_]*)+$",
            "examples": [
              "com.hiromoto.breezepush",
              "com.hiromoto.breezepush.stg"
            ],
            "description": "Android package/applicationId. Must match this deployment FCM_ANDROID_PACKAGE or registration returns 422 app_mismatch. This guard is not authentication and is not the Firebase App ID (1:...:android:...). The server chooses the Firebase project."
          }
        }
      },
      "ChannelRegistration": {
        "type": "object",
        "required": [
          "channel_id",
          "management_secret",
          "key"
        ],
        "properties": {
          "channel_id": {
            "type": "string",
            "minLength": 16,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "management_secret": {
            "type": "string",
            "minLength": 32,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Client-generated CSPRNG secret; use at least 32 random bytes before encoding."
          },
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_g_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          }
        }
      },
      "Rotate": {
        "type": "object",
        "required": [
          "new_key"
        ],
        "properties": {
          "new_key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          }
        }
      },
      "Attach": {
        "type": "object",
        "required": [
          "device_management_secret"
        ],
        "properties": {
          "device_management_secret": {
            "type": "string",
            "minLength": 32,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Client-generated CSPRNG secret; use at least 32 random bytes before encoding."
          }
        }
      },
      "TargetRegistration": {
        "type": "object",
        "required": [
          "target_id",
          "kind",
          "key",
          "token",
          "environment"
        ],
        "properties": {
          "target_id": {
            "type": "string",
            "minLength": 16,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_t_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "token": {
            "type": "string",
            "pattern": "^(?:[A-Fa-f0-9]{2}){1,2048}$"
          },
          "kind": {
            "enum": [
              "liveactivity",
              "controls",
              "widgets",
              "voip",
              "pushtotalk",
              "location",
              "fileprovider",
              "complication",
              "mdm",
              "accessory"
            ]
          },
          "scope": {
            "enum": [
              "start",
              "activity"
            ],
            "description": "Required only for liveactivity."
          },
          "environment": {
            "type": "string",
            "enum": [
              "sandbox",
              "production"
            ]
          }
        }
      },
      "Push": {
        "type": "object",
        "additionalProperties": true,
        "description": "Union of provider-specific send fields, not a claim that every field works on every platform. The stored webhook target selects the provider. For Android use AndroidPush: only visible alerts or explicit id deletion, flat data-only transport, no badge/ciphertext/custom sound/raw Apple payload. Mixed batches must satisfy every target provider.",
        "properties": {
          "message": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "subtitle": {
            "type": "string"
          },
          "thread_id": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "level": {
            "enum": [
              "passive",
              "active",
              "timeSensitive",
              "time-sensitive",
              "critical"
            ],
            "description": "Android critical is always rejected. Other levels map to client-owned level channels; no DND bypass guarantee."
          },
          "interruption_level": {
            "enum": [
              "passive",
              "active",
              "time-sensitive",
              "critical"
            ],
            "description": "Alias of level. Critical requires Apple approval and server/client enablement; Android rejects it."
          },
          "badge": {
            "type": "integer",
            "minimum": 0,
            "maximum": 99999,
            "description": "Apple only; Android rejects this field."
          },
          "sound": {
            "type": "string",
            "description": "Apple bundled sound. Android accepts only default/system using its existing channel behavior."
          },
          "volume": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Apple only; Android rejects this field."
          },
          "open_url": {
            "type": "string",
            "format": "uri"
          },
          "image_url": {
            "type": "string",
            "format": "uri"
          },
          "icon_url": {
            "type": "string",
            "format": "uri"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Android requires HTTPS, without embedded credentials."
          },
          "image": {
            "type": "string",
            "format": "uri"
          },
          "icon": {
            "type": "string",
            "format": "uri"
          },
          "copy": {
            "type": "string"
          },
          "markdown": {
            "type": "string",
            "description": "Markdown body text, not a boolean flag."
          },
          "ciphertext": {
            "type": "string",
            "description": "Apple client capability only; Android rejects ciphertext and iv."
          },
          "iv": {
            "type": "string",
            "description": "Apple client capability only."
          },
          "push_type": {
            "enum": [
              "alert",
              "background",
              "liveactivity",
              "controls",
              "widgets",
              "voip",
              "pushtotalk",
              "location",
              "fileprovider",
              "complication",
              "mdm",
              "accessory"
            ],
            "description": "Apple framework types require the corresponding client token and operator gate. Android supports alert; background is only permitted for delete=1 with the specified id."
          },
          "payload": {
            "type": "object",
            "description": "Apple only: framework-specific payload, up to 4096 UTF-8 bytes or 5120 for VoIP. Android rejects raw payload/APS."
          },
          "data": {
            "type": "object",
            "description": "Apple supports custom JSON. Android only flat string metadata with reserved/control keys forbidden; see AndroidPush."
          },
          "priority": {
            "enum": [
              1,
              5,
              10,
              "normal",
              "high"
            ],
            "description": "Apple: 1/5/10 subject to push-type rules. Android: normal/high; passive and delete require normal. Omit in mixed batches."
          },
          "ttl": {
            "type": "integer",
            "minimum": 0,
            "maximum": 31536000,
            "description": "Android delivery TTL: 0..2419200 seconds (default four weeks). Apple ttl is client metadata, 0..31536000; use its expiration controls for delivery expiration."
          },
          "expiration_date": {
            "type": "string",
            "format": "date-time",
            "description": "Future delivery expiration. Android requires within four weeks and forbids combining with ttl."
          },
          "apns_expiration": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Apple only; Android rejects this field."
          },
          "collapse_id": {
            "type": "string",
            "maxLength": 128,
            "description": "At most 64 UTF-8 bytes; collapse_key is an alias for collapse_id. Use only one value. Collapses pending messages, not delivered history."
          },
          "delete": {
            "enum": [
              true,
              false,
              1,
              0,
              "1",
              "0"
            ],
            "description": "Android delete=1 requires the previous message id and normal priority, without display or data fields; ordinary background sync is unsupported."
          },
          "id": {
            "type": "string",
            "maxLength": 128
          },
          "device_key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "device_keys": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "minLength": 27,
              "maxLength": 27,
              "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
              "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
            }
          }
        }
      },
      "AndroidPush": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/AndroidAlertPush"
          },
          {
            "$ref": "#/components/schemas/AndroidDeletePush"
          }
        ],
        "description": "Current Android client contract. HTTP v1 message.fid plus flat string data only: no notification object, no data.breeze, no server-selected channel. Complete Google request is conservatively limited to 4096 UTF-8 bytes. badge/ciphertext/iv/raw Apple payload/custom sound/critical are unsupported; ordinary background sync returns 422."
      },
      "AndroidAlertPush": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Business message ID; generated for an alert if absent. Required to delete the matching stored notification."
          },
          "ttl": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2419200,
            "default": 2419200,
            "description": "FCM TTL in seconds, at most four weeks. 0 means immediate delivery attempt only. Numeric strings are also accepted in form/query input."
          },
          "expiration_date": {
            "type": "string",
            "format": "date-time",
            "description": "Future ISO8601 time within four weeks, converted to TTL. Mutually exclusive with ttl."
          },
          "priority": {
            "type": "string",
            "enum": [
              "normal",
              "high"
            ],
            "description": "Android only. Visible alerts default to high; passive alerts and deletion require normal. It does not bypass notification permissions or system channel settings."
          },
          "collapse_id": {
            "type": "string",
            "maxLength": 128,
            "description": "At most 64 UTF-8 bytes; collapse_key is an alias for collapse_id. Use only one value. Collapses pending messages, not delivered history."
          },
          "collapse_key": {
            "type": "string",
            "maxLength": 128,
            "description": "At most 64 UTF-8 bytes; collapse_key is an alias for collapse_id. Use only one value. Collapses pending messages, not delivered history."
          },
          "device_key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "device_keys": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "minLength": 27,
              "maxLength": 27,
              "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
              "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
            }
          },
          "push_type": {
            "type": "string",
            "const": "alert",
            "default": "alert"
          },
          "delete": {
            "enum": [
              false,
              0,
              "0"
            ]
          },
          "title": {
            "type": "string",
            "maxLength": 2048
          },
          "subtitle": {
            "type": "string",
            "maxLength": 2048
          },
          "body": {
            "type": "string",
            "maxLength": 2048
          },
          "message": {
            "type": "string",
            "maxLength": 2048,
            "description": "Alias of body."
          },
          "markdown": {
            "type": "string",
            "maxLength": 2048,
            "description": "Markdown body text, not a boolean flag. Do not combine with a different body."
          },
          "group": {
            "type": "string",
            "maxLength": 256
          },
          "thread_id": {
            "type": "string",
            "maxLength": 256,
            "description": "Alias of group."
          },
          "level": {
            "type": "string",
            "enum": [
              "active",
              "passive",
              "timeSensitive",
              "time-sensitive"
            ],
            "default": "active"
          },
          "interruption_level": {
            "type": "string",
            "enum": [
              "active",
              "passive",
              "timeSensitive",
              "time-sensitive"
            ],
            "description": "Alias of level. Android critical is unavailable."
          },
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "HTTPS only, without embedded username/password."
          },
          "open_url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "Alias of url; HTTPS only."
          },
          "image": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "HTTPS only, without embedded username/password."
          },
          "image_url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "Alias of image."
          },
          "icon": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "HTTPS only, without embedded username/password."
          },
          "icon_url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri",
            "pattern": "^https://[^\\s/?#@]+(?:[/?#][^\\s]*)?$",
            "description": "Alias of icon."
          },
          "copy": {
            "type": "string",
            "maxLength": 2048
          },
          "sound": {
            "type": "string",
            "enum": [
              "default",
              "system"
            ],
            "description": "Existing client level channel sound only; custom sounds and silent overrides are unsupported."
          },
          "data": {
            "type": "object",
            "maxProperties": 128,
            "additionalProperties": {
              "type": "string"
            },
            "propertyNames": {
              "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,127}$",
              "not": {
                "pattern": "^(?:[iI][dD]|[tT][sS]|[dD][eE][lL][eE][tT][eE]|[tT][iI][tT][lL][eE]|[sS][uU][bB][tT][iI][tT][lL][eE]|[bB][oO][dD][yY]|[mM][aA][rR][kK][dD][oO][wW][nN]|[gG][rR][oO][uU][pP]|[uU][rR][lL]|[iI][mM][aA][gG][eE]|[iI][cC][oO][nN]|[cC][oO][pP][yY]|[lL][eE][vV][eE][lL]|[sS][oO][uU][nN][dD]|[bB][aA][dD][gG][eE]|[cC][iI][pP][hH][eE][rR][tT][eE][xX][tT]|[iI][vV]|[fF][iI][dD]|[tT][oO][kK][eE][nN]|[mM][eE][sS][sS][aA][gG][eE]|[aA][nN][dD][rR][oO][iI][dD]|[aA][nN][dD][rR][oO][iI][dD]_[vV]2|[aA][pP][nN][sS]|[nN][oO][tT][iI][fF][iI][cC][aA][tT][iI][oO][nN]|[pP][rR][oO][vV][iI][dD][eE][rR]|[aA][dD][dD][rR][eE][sS][sS]_[kK][iI][nN][dD]|[pP][rR][oO][jJ][eE][cC][tT]_[iI][dD]|[fF][iI][rR][eE][bB][aA][sS][eE]_[pP][rR][oO][jJ][eE][cC][tT]_[iI][dD]|[aA][pP][pP][lL][iI][cC][aA][tT][iI][oO][nN]_[iI][dD]|[aA][pP][pP]_[iI][dD]|[pP][aA][cC][kK][aA][gG][eE]_[nN][aA][mM][eE]|[bB][rR][eE][eE][zZ][eE]|[fF][rR][oO][mM]|[mM][eE][sS][sS][aA][gG][eE]_[tT][yY][pP][eE])$|^(?:[gG][oO][oO][gG][lL][eE]|[gG][cC][mM])\\."
              }
            },
            "description": "Flat string metadata. Cannot replace controls or use Google reserved keys. The current Android client does not display or persist unknown custom fields in its history model."
          }
        },
        "anyOf": [
          {
            "required": [
              "title"
            ],
            "properties": {
              "title": {
                "type": "string",
                "pattern": "\\S"
              }
            }
          },
          {
            "required": [
              "subtitle"
            ],
            "properties": {
              "subtitle": {
                "type": "string",
                "pattern": "\\S"
              }
            }
          },
          {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "type": "string",
                "pattern": "\\S"
              }
            }
          },
          {
            "required": [
              "message"
            ],
            "properties": {
              "message": {
                "type": "string",
                "pattern": "\\S"
              }
            }
          },
          {
            "required": [
              "markdown"
            ],
            "properties": {
              "markdown": {
                "type": "string",
                "pattern": "\\S"
              }
            }
          }
        ],
        "allOf": [
          {
            "not": {
              "required": [
                "ttl",
                "expiration_date"
              ]
            }
          },
          {
            "if": {
              "anyOf": [
                {
                  "required": [
                    "level"
                  ],
                  "properties": {
                    "level": {
                      "const": "passive"
                    }
                  }
                },
                {
                  "required": [
                    "interruption_level"
                  ],
                  "properties": {
                    "interruption_level": {
                      "const": "passive"
                    }
                  }
                }
              ]
            },
            "then": {
              "properties": {
                "priority": {
                  "const": "normal"
                }
              }
            }
          }
        ]
      },
      "AndroidDeletePush": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "delete",
          "id"
        ],
        "description": "Only implemented Android background operation: remove the matching history/notification id. No alert, group, custom data or sound. Uses normal priority; delivery is not guaranteed.",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Business message ID; generated for an alert if absent. Required to delete the matching stored notification."
          },
          "ttl": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2419200,
            "default": 2419200,
            "description": "FCM TTL in seconds, at most four weeks. 0 means immediate delivery attempt only. Numeric strings are also accepted in form/query input."
          },
          "expiration_date": {
            "type": "string",
            "format": "date-time",
            "description": "Future ISO8601 time within four weeks, converted to TTL. Mutually exclusive with ttl."
          },
          "priority": {
            "type": "string",
            "const": "normal",
            "default": "normal"
          },
          "collapse_id": {
            "type": "string",
            "maxLength": 128,
            "description": "At most 64 UTF-8 bytes; collapse_key is an alias for collapse_id. Use only one value. Collapses pending messages, not delivered history."
          },
          "collapse_key": {
            "type": "string",
            "maxLength": 128,
            "description": "At most 64 UTF-8 bytes; collapse_key is an alias for collapse_id. Use only one value. Collapses pending messages, not delivered history."
          },
          "device_key": {
            "type": "string",
            "minLength": 27,
            "maxLength": 27,
            "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
            "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
          },
          "device_keys": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "minLength": 27,
              "maxLength": 27,
              "pattern": "^bz_[dgt]_[A-Za-z0-9_-]{21}[AQgw]$",
              "description": "Typed Breeze send key: bz_d_ (device), bz_g_ (group), bz_t_ (target), plus unpadded Base64URL of 16 CSPRNG bytes."
            }
          },
          "delete": {
            "enum": [
              true,
              1,
              "1"
            ]
          },
          "push_type": {
            "type": "string",
            "const": "background"
          }
        },
        "allOf": [
          {
            "not": {
              "required": [
                "ttl",
                "expiration_date"
              ]
            }
          }
        ]
      }
    }
  }
}
