{
  "openapi": "3.1.2",
  "info": {
    "title": "Praxical developer API",
    "version": "0.1.0",
    "description": "Implemented v1 integration contract candidate. Browser owner operations require current authorization; publisher automation is limited to its declared product and release scopes. Production activation is a separate readiness gate.",
    "contact": {
      "name": "Praxical platform owner"
    }
  },
  "servers": [
    {
      "url": "https://store.praxical.io",
      "description": "Intended production origin; this contract does not activate a deployment."
    }
  ],
  "tags": [
    {
      "name": "Catalog",
      "description": "Catalog operations."
    },
    {
      "name": "Commerce",
      "description": "Commerce operations."
    },
    {
      "name": "Distribution",
      "description": "Distribution operations."
    },
    {
      "name": "Publisher identity",
      "description": "Publisher identity operations."
    },
    {
      "name": "Publisher integrations",
      "description": "Publisher integrations operations."
    },
    {
      "name": "Publishing",
      "description": "Publishing operations."
    }
  ],
  "paths": {
    "/api/v1/products/{product}/channels/{channel}/membership": {
      "delete": {
        "operationId": "leaveChannel",
        "summary": "Leave a release channel and clear its account preference",
        "description": "Authenticated customer; own resource only. Own participation only. Revokes restricted-channel access, including future requests using previously issued links. Public downloads remain public. Installed software is not removed.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Leave a release channel and clear its account preference.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "left": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "left"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      },
      "post": {
        "operationId": "joinChannel",
        "summary": "Join an open channel or request publisher approval",
        "description": "Authenticated customer; own resource only. Own participation only. Invitation-only channels require a matching invitation. Denied/revoked restricted participants need publisher intervention. At most 5000 active participants and requests per channel.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Join an open channel or request publisher approval.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "pending",
                        "approved"
                      ]
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/products/{product}/recommendations/me": {
      "delete": {
        "operationId": "deleteRecommendation",
        "summary": "Delete your recommendation and clear its text",
        "description": "Authenticated customer; own resource only. Own recommendation on a current public/unlisted app. A tombstone retains moderation state to prevent bypass by re-creation. Revision must match; deletion removes it from aggregates.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Delete your recommendation and clear its text.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OwnRecommendation"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      },
      "get": {
        "operationId": "myRecommendation",
        "summary": "Read your recommendation and eligibility",
        "description": "Authenticated customer; own resource only. Active account and public/unlisted active-publisher app. Own moderation reason and tombstone revision remain visible.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read your recommendation and eligibility.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MyRecommendation"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "put": {
        "operationId": "saveRecommendation",
        "summary": "Save a thumbs-up/down recommendation with optional text",
        "description": "Authenticated customer; own resource only. Own account only, qualified by a completed signed-in download or historical personal purchase. Publisher members and platform staff excluded. expected_revision=0 creates; otherwise use the current revision. Text is plain text with a 4,000 Unicode character limit. Edits/re-creation preserve moderator suppression. Refunds/cancellation do not remove eligibility.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Save a thumbs-up/down recommendation with optional text.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OwnRecommendation"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "recommended": {
                    "type": "boolean"
                  },
                  "body": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 0
                  }
                },
                "required": [
                  "recommended",
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/channel-invitations/{invitation}": {
      "delete": {
        "operationId": "revokeChannelInvitation",
        "summary": "Revoke a pending release-channel invitation",
        "description": "Current owner/release_manager of the active publisher organization. Idempotent. Accepted participants are managed with the membership endpoint.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Revoke a pending release-channel invitation.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "revoked": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "revoked"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "invitation",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/credentials/{credential}": {
      "delete": {
        "operationId": "revokePublisherCredential",
        "summary": "Revoke a publisher automation credential",
        "description": "Active publisher organization owner with recent MFA. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "204": {
            "description": "Revoke a publisher automation credential.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner with recent MFA.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "credential",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/offers/{offer}": {
      "delete": {
        "operationId": "retireOffer",
        "summary": "Retire an offer for new checkouts",
        "description": "Current owner/release_manager of the active publisher organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "204": {
            "description": "Retire an offer for new checkouts.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "offer",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/private-access/{organization}": {
      "delete": {
        "operationId": "revokePrivateAccess",
        "summary": "Change an organization's private catalog access",
        "description": "Product's active publisher owner/release_manager with recent MFA. Grant target must be an active buyer/both organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Change an organization's private catalog access.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "saved": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "saved"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Product's active publisher owner/release_manager with recent MFA. Grant target must be an active buyer/both organization.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "put": {
        "operationId": "grantPrivateAccess",
        "summary": "Change an organization's private catalog access",
        "description": "Product's active publisher owner/release_manager with recent MFA. Grant target must be an active buyer/both organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Change an organization's private catalog access.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "saved": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "saved"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Product's active publisher owner/release_manager with recent MFA. Grant target must be an active buyer/both organization.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}": {
      "delete": {
        "operationId": "archiveWebhook",
        "summary": "Remove a receiver and cancel queued deliveries",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. ",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Remove a receiver and cancel queued deliveries.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "archived": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "archived"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      },
      "put": {
        "operationId": "updateWebhook",
        "summary": "Update receiver URL, events or enabled state",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. URL change, pause or event removal cancels affected queued deliveries; already in-flight sends may arrive. Saving binds management to the current owner, whose membership is checked again at delivery.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Update receiver URL, events or enabled state.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "saved": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "saved"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048
                  },
                  "events": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "release.validation_passed",
                        "release.validation_failed",
                        "release.published",
                        "release.withdraw",
                        "release.scheduled",
                        "release.schedule_blocked",
                        "listing.publish",
                        "payment.confirmed",
                        "purchase.access_changed",
                        "refund.approved",
                        "refund.declined",
                        "gift.redeemed",
                        "license_code.redeemed",
                        "license_batch.created",
                        "license_batch.revoked"
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 15
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "name",
                  "url",
                  "events",
                  "enabled",
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/releases/{release}/attestation": {
      "delete": {
        "operationId": "clearReleaseAttestation",
        "summary": "Attach or clear publisher provenance on a mutable release",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Attach or clear publisher provenance on a mutable release.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "saved": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "saved"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "put": {
        "operationId": "releaseAttestation",
        "summary": "Attach or clear publisher provenance on a mutable release",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Attach or clear publisher provenance on a mutable release.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "saved": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "saved"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttestationInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/releases/{release}/schedule": {
      "delete": {
        "operationId": "cancelReleaseSchedule",
        "summary": "Cancel a publication schedule that has not started",
        "description": "Current owner/release_manager of the active publisher organization. Recent browser MFA required. Matching current schedule revision required. Cancels scheduled/blocked entries; queued publication returns 409 and must be handled through its operation and release controls. A stale scheduled job cannot publish a canceled or rescheduled release.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Cancel a publication schedule that has not started.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "canceled": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "canceled"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Recent browser MFA required.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 4000,
                    "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
                  }
                },
                "required": [
                  "expected_revision",
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      },
      "put": {
        "operationId": "scheduleRelease",
        "summary": "Schedule publication of an approved release",
        "description": "Current owner/release_manager of the active publisher organization. Recent browser MFA required. Choose one minute to 90 days ahead. Schedule revision 0 creates; subsequent edits require the current revision. Binds exact approved release revision/digest. Worker rechecks scheduler activity, organization membership/role, approval and publisher assertion when due. Schedule becomes blocked if authorization/content changed or more than 24 hours overdue. Queueing and schedule transition are atomic; signer/storage work follows asynchronously. No native or publisher-credential scheduling authority is granted.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Schedule publication of an approved release.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicationSchedule"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Recent browser MFA required.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "publish_at": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 0
                  },
                  "expected_release_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 4000,
                    "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
                  }
                },
                "required": [
                  "publish_at",
                  "expected_revision",
                  "expected_release_revision",
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/config": {
      "get": {
        "operationId": "publicConfig",
        "summary": "Read public runtime capabilities",
        "description": "Anonymous. ",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read public runtime capabilities.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreConfig"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      }
    },
    "/api/v1/discovery/placements": {
      "get": {
        "operationId": "publicPlacements",
        "summary": "Read current Staff Picks and sponsored placements",
        "description": "Public. Scheduled active placements for currently public apps and active publishers only. Sponsored labels and publisher attribution must remain visible. These placements never affect download rankings. Sponsorship billing is not implemented by this API.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read current Staff Picks and sponsored placements.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlacementCard"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Public. Scheduled active placements for currently public apps and active publishers only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      }
    },
    "/api/v1/embed/offers/{offer}": {
      "get": {
        "operationId": "embedOffer",
        "summary": "Read an offer's embedded checkout card",
        "description": "Anonymous. Paid, active offers of public or unlisted apps only (404 offer_not_found otherwise). frame_ancestors are the sites that may frame the card at /embed/offers/{offer}. A checkout started from the card sends embed_origin, which must be one of them (422 embed_origin_not_allowed), and returns to /checkout/{order}?embedded=1, which reports praxical:purchase to the card.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read an offer's embedded checkout card.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmbedOffer"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "offer",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/entitlement-keys": {
      "get": {
        "operationId": "entitlementKeys",
        "summary": "Read the keys that verify entitlement tokens",
        "description": "Anonymous. Cache for up to an hour. During a key rotation both keys are listed; select by kid.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read the keys that verify entitlement tokens.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JSONWebKeySet"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      }
    },
    "/api/v1/me/entitlements": {
      "get": {
        "operationId": "myEntitlements",
        "summary": "List visible entitlements and current assignment state",
        "description": "Authenticated customer; own resource only. The account's own grants and its organizations' grants, newest first, paged like orders; staff access to other buyers' grants is not listed here. Clients that need every grant follow next_cursor. active describes current policy timing; assigned describes this account's beneficiary relation. A product/release decision remains authoritative.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "List visible entitlements and current assignment state.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/EntitlementView"
                      }
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "items",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "next_cursor from the previous page."
          }
        ]
      }
    },
    "/api/v1/me/gifts": {
      "get": {
        "operationId": "gifts",
        "summary": "List your most recent gift purchases",
        "description": "Authenticated customer; own resource only. At most 100 most recent gift codes. No raw codes or recipient identities are returned. Pending unpaid checkouts remain in orders.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List your most recent gift purchases.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GiftCode"
                      }
                    },
                    "available": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "items",
                    "available"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      }
    },
    "/api/v1/me/license-redemptions/{redemption}": {
      "get": {
        "operationId": "licenseRedemption",
        "summary": "Read your redemption request",
        "description": "Authenticated customer; own resource only. ",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read your redemption request.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseRedemption"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "redemption",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/me/orders": {
      "get": {
        "operationId": "orders",
        "summary": "List accessible orders",
        "description": "Personal billing owner or current organization owner/billing_admin. Newest first (created_at, then ID). Pass next_cursor back as cursor for the next page; null means the list is complete. 400 invalid_limit or invalid_cursor.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List accessible orders.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Order"
                      }
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "items",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "next_cursor from the previous page."
          }
        ]
      }
    },
    "/api/v1/me/subscriptions": {
      "get": {
        "operationId": "subscriptions",
        "summary": "List accessible subscriptions",
        "description": "Personal billing owner or current organization owner/billing_admin. Open subscriptions (incomplete, active, past_due) first, then canceled and expired ones; each newest first. Paged like orders.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List accessible subscriptions.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SubscriptionView"
                      }
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "items",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "next_cursor from the previous page."
          }
        ]
      }
    },
    "/api/v1/media/{media}/content": {
      "get": {
        "operationId": "mediaContent",
        "summary": "Read currently visible AVIF image bytes",
        "description": "Current approved listing image visibility (as for product detail, so a suspended publisher's images only for its members), or the app's active owner/release_manager or active operator/reviewer. Unselected draft images return 404. GET and HEAD. Always rechecks visibility; private, no-store. Asset bytes and processing recipe are immutable. UUID knowledge does not grant draft access.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read currently visible AVIF image bytes.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "image/avif": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current approved listing image visibility (as for product detail, so a suspended publisher's images only for its members), or the app's active owner/release_manager or active operator/reviewer. Unselected draft images return 404.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "media",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/offers/{offer}": {
      "get": {
        "operationId": "offer",
        "summary": "Read a currently available offer and eligible buyers",
        "description": "Anonymous for public/unlisted product; otherwise authorized private-catalog member. ",
        "tags": [
          "Commerce"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a currently available offer and eligible buyers.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferDetail"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous for public/unlisted product; otherwise authorized private-catalog member.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "offer",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/operations/{operation}": {
      "get": {
        "operationId": "operation",
        "summary": "Read a release validation or publication operation",
        "description": "Authorized publisher reader/scoped credential or platform operator. Payment/privacy operations use their own resource views. Also accepts a current product-scoped publisher credential with release:read. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a release validation or publication operation.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleaseOperation"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authorized publisher reader/scoped credential or platform operator. Payment/privacy operations use their own resource views. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "operation",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/orders/{order}": {
      "get": {
        "operationId": "order",
        "summary": "Read an order, receipt and its payment operations",
        "description": "Personal billing owner or current organization owner/billing_admin. The /receipt alias returns the same JSON receipt facts. Embedded operations are payment operations; /operations/{operation} is reserved for release work. Native clients poll this read after checkout: about every 2.5 seconds while the app is waiting in the foreground, backing off to 30 seconds or more otherwise. pending/processing grant nothing; stop at paid, failed or expired. Paid access is the embedded entitlement (or, for organizations, the organization's seats), rechecked by delivery. After a canceled hosted page the order stays processing until the provider expires the session, so the app can reopen checkout_url.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read an order, receipt and its payment operations.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderDetail"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/orders/{order}/receipt": {
      "get": {
        "operationId": "orderReceipt",
        "summary": "Read an order, receipt and its payment operations",
        "description": "Personal billing owner or current organization owner/billing_admin. The /receipt alias returns the same JSON receipt facts. Embedded operations are payment operations; /operations/{operation} is reserved for release work. Native clients poll this read after checkout: about every 2.5 seconds while the app is waiting in the foreground, backing off to 30 seconds or more otherwise. pending/processing grant nothing; stop at paid, failed or expired. Paid access is the embedded entitlement (or, for organizations, the organization's seats), rechecked by delivery. After a canceled hosted page the order stays processing until the provider expires the session, so the app can reopen checkout_url.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read an order, receipt and its payment operations.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderDetail"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/products": {
      "get": {
        "operationId": "products",
        "summary": "Search public products",
        "description": "Anonymous; public active publisher listings only. Offset pagination with stable name/ID tiebreaks. Defaults to featured ordering. Downloads sort uses complete transfer counts, not installations; newest/updated use listing timestamps. License matches the publisher's declared string case-insensitively. Source filter only requires a source URL and makes no licensing claim. Architecture/format must match the same ready artifact on a published release in a public channel; official commercial access may still be required. No total count or search snapshot is promised.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Search public products.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductPage"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous; public active publisher listings only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "price",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "free"
              ]
            }
          },
          {
            "in": "query",
            "name": "publisher_id",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "architecture",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "x86_64",
                "aarch64"
              ]
            }
          },
          {
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "appdir",
                "appimage",
                "flatpak"
              ]
            }
          },
          {
            "in": "query",
            "name": "license",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "in": "query",
            "name": "source",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "available"
              ]
            }
          },
          {
            "in": "query",
            "name": "downloadable",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            }
          },
          {
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "featured",
                "name",
                "newest",
                "updated",
                "downloads",
                "relevance"
              ]
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 24
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          }
        ]
      }
    },
    "/api/v1/products/{product}": {
      "get": {
        "operationId": "product",
        "summary": "Read a visible product",
        "description": "Anonymous public/unlisted listing of an active publisher; otherwise entitled buyer, assigned beneficiary or permitted organization member. A suspended publisher's listings are visible only to its members and active operators/reviewers. Invisible resources return 404. A listing hidden by publisher suspension returns the same 404 not_found as an unknown app, also to buyers who hold a grant for it; account history (library, orders, entitlements) keeps listing it. Releases are empty while the publisher is suspended, because its release channels close.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a visible product.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDetail"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous public/unlisted listing of an active publisher; otherwise entitled buyer, assigned beneficiary or permitted organization member. A suspended publisher's listings are visible only to its members and active operators/reviewers. Invisible resources return 404.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "description": "UUID or URL slug."
            }
          }
        ]
      }
    },
    "/api/v1/products/{product}/channels": {
      "get": {
        "operationId": "productChannels",
        "summary": "Read available release channels and the account preference",
        "description": "Visible app. Invitation-only channels are listed for participants and publisher editors; approved participation permits private app visibility. Channel access is separate from paid entitlement. Heads are only returned for allowed channels. selected is the valid account preference or stable; it does not guarantee a compatible build. Public trust metadata can reveal channel names and target hashes.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read available release channels and the account preference.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductChannels"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Visible app. Invitation-only channels are listed for participants and publisher editors; approved participation permits private app visibility.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/products/{product}/recommendations": {
      "get": {
        "operationId": "productRecommendations",
        "summary": "Read customer recommendations and aggregate approval",
        "description": "Currently public or unlisted app from an active publisher. One thumbs-up/down recommendation per account and app; optional plain text. Excludes deleted, moderated, inactive and publisher/staff-affiliated authors. No recommendations means a null percentage. Recent counts use creation time within 30 days; newest first, stable ID tiebreak. Download or historical personal purchase qualifies; no installation/usage claim is made.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read customer recommendations and aggregate approval.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecommendationPage"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Currently public or unlisted app from an active publisher.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/products/{product}/releases": {
      "get": {
        "operationId": "productReleases",
        "summary": "Read a product's published release history",
        "description": "Same visibility as product detail. Artifact authorization is separate. ",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a product's published release history.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CatalogRelease"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Same visibility as product detail. Artifact authorization is separate.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "description": "UUID or URL slug."
            }
          }
        ]
      }
    },
    "/api/v1/products/{product}/stats": {
      "get": {
        "operationId": "productStatistics",
        "summary": "Read an app's download totals and history",
        "description": "App visible as for product detail (so not a suspended publisher's app except to its members and staff); private apps also need publisher owner/release manager. ",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read an app's download totals and history.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductStatistics"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "App visible as for product detail (so not a suspended publisher's app except to its members and staff); private apps also need publisher owner/release manager.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "30",
                "90",
                "365"
              ]
            }
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "description": "UUID or URL slug."
            }
          }
        ]
      }
    },
    "/api/v1/publisher/organizations": {
      "get": {
        "operationId": "publisherOrganizations",
        "summary": "List publisher workspaces",
        "description": "Current membership in this organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List publisher workspaces.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublisherOrganization"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current membership in this organization.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      }
    },
    "/api/v1/publisher/organizations/{organization}/keys": {
      "get": {
        "operationId": "publisherKeys",
        "summary": "Read the organization's public signing identities",
        "description": "Current member of the active publisher organization. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read the organization's public signing identities.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicPublisherKey"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "post": {
        "operationId": "registerPublisherKey",
        "summary": "Register a verified publisher public key",
        "description": "Challenge owner and current publisher owner with recent MFA; sign the exact challenge payload bytes. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Register a verified publisher public key.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Challenge owner and current publisher owner with recent MFA; sign the exact challenge payload bytes.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "challenge_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "signature": {
                    "type": "string",
                    "pattern": "^[A-Fa-f0-9]{128}$"
                  }
                },
                "required": [
                  "challenge_id",
                  "signature"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products": {
      "get": {
        "operationId": "publisherProducts",
        "summary": "List products in current active publisher workspaces",
        "description": "Current membership in this organization. At most 100 products ordered by name.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List products in current active publisher workspaces.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublisherProductRecord"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current membership in this organization.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard"
      },
      "post": {
        "operationId": "createProduct",
        "summary": "Create a product and listing draft",
        "description": "Current owner/release_manager of the active publisher organization. Application ID is permanent and unique; omitted IDs receive a platform namespace. Optional initial_offer is created atomically with the app and requires recent authentication. A release-family initial offer uses the newly created first family; omit its family_id. Initial offers cannot replace an offer.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a product and listing draft.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "organization_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "slug": {
                    "type": "string",
                    "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
                    "maxLength": 80
                  },
                  "listing": {
                    "$ref": "#/components/schemas/ListingInput"
                  },
                  "application_id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_]*([.][a-z][a-z0-9_]*){2,}$",
                    "maxLength": 200
                  },
                  "initial_offer": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/OfferInput"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "organization_id",
                  "slug",
                  "listing"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}": {
      "get": {
        "operationId": "publisherProduct",
        "summary": "Read a publisher product workspace",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a publisher product workspace.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherProduct"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/buyers/{buyer}": {
      "get": {
        "operationId": "publisherBuyer",
        "summary": "Read what one buyer holds for the app",
        "description": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read. All current and past access from any source (purchase, gift, license code or an organization seat) and the buyer's paid purchases. active is true while any entry is active. An entry is active while it is current, the app's publisher is active and the holder can use it: a person's own grant while their account is active, an organization seat while they belong to the active organization, an organization's grant while it is active. Delivery makes the same decision. Use it to answer an entitlement token's sub, or a buyer_id from a webhook.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read what one buyer holds for the app.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherBuyer"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "purchases:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "buyer",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/channel-policies": {
      "get": {
        "operationId": "publisherChannels",
        "summary": "Read release-channel settings, participants and invitations",
        "description": "Current owner/release_manager of the active publisher organization. Participant names/emails are shared when requesting or accepting channel access. Invitation bearer secrets are excluded.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read release-channel settings, participants and invitations.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChannelPolicy"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/credentials": {
      "get": {
        "operationId": "publisherCredentials",
        "summary": "List product-scoped automation credentials",
        "description": "Active publisher organization owner. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List product-scoped automation credentials.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublisherCredential"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "post": {
        "operationId": "createPublisherCredential",
        "summary": "Issue an expiring product automation credential",
        "description": "Active publisher organization owner with recent MFA. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Issue an expiring product automation credential.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "token": {
                      "type": "string",
                      "description": "Shown once. Store securely; never log or send with browser cookies."
                    }
                  },
                  "required": [
                    "id",
                    "token"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner with recent MFA.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CredentialInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/embed": {
      "get": {
        "operationId": "embedSettings",
        "summary": "Read the app's embedded checkout settings",
        "description": "Active publisher owner of the app; browser session only. The sites that may show the checkout card, the app's paid offers, and the script URL. A page shows the card with a `div` whose `data-praxical-offer` attribute is the offer ID, followed by an async script element that loads the script URL.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read the app's embedded checkout settings.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmbedSettings"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher owner of the app; browser session only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "put": {
        "operationId": "setEmbedOrigins",
        "summary": "Replace the sites that may embed the app's checkout",
        "description": "Active publisher owner of the app; browser session only. Origins only (scheme, host, optional port), normalized to lowercase without default ports; https is required, except http://localhost in development. IPv6 addresses are refused (400 ipv6_origin) because browsers do not match them in frame-ancestors; use a host name. Up to 10. An empty list turns embedding off. Removing a site stops new checkouts from it at once; its framed cards stop rendering as caches expire (one minute).",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Replace the sites that may embed the app's checkout.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmbedSettings"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher owner of the app; browser session only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "origins": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200
                    },
                    "maxItems": 10
                  }
                },
                "required": [
                  "origins"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/license-code-batches": {
      "get": {
        "operationId": "licenseBatches",
        "summary": "List publisher license code batches",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. At most 100 most recent batches. Counts do not expose recipient identities or raw codes.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List publisher license code batches.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LicenseBatch"
                      }
                    },
                    "available": {
                      "type": "boolean"
                    },
                    "daily_limit": {
                      "type": "integer",
                      "const": 1000
                    },
                    "batch_limit": {
                      "type": "integer",
                      "const": 100
                    }
                  },
                  "required": [
                    "items",
                    "available",
                    "daily_limit",
                    "batch_limit"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "post": {
        "operationId": "createLicenseBatch",
        "summary": "Issue personal release-family license codes",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Public/unlisted app, belonging release family, configured encrypted code storage. Optional redemption expiry between one hour and one year; no expiry by default. Up to 1,000 codes per app/day. Codes contain 160 random bits, stored by hash with encrypted reveal material. Expiry does not shorten an already-redeemed entitlement.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Issue personal release-family license codes.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 200
            },
            "description": "Stable opaque key for this actor/command. Same key and normalized body returns the existing result; changed body returns 409. Persist across timeouts; do not generate a new key to guess whether money moved."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "family_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "quantity": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "expires_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "family_id",
                  "label",
                  "quantity"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/link": {
      "get": {
        "operationId": "linkSettings",
        "summary": "Read the app's account-linking settings",
        "description": "Active publisher owner of the app; browser session only. Send buyers to authorize_url?redirect_uri=<a listed address>&state=<your CSRF state>.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read the app's account-linking settings.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LinkSettings"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher owner of the app; browser session only.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "put": {
        "operationId": "setLinkRedirects",
        "summary": "Replace the addresses that receive linked buyers",
        "description": "Active publisher owner of the app; browser session only. Exact URLs (path and query kept, no fragment); https, except http://localhost in development. Up to 5.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Replace the addresses that receive linked buyers.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LinkSettings"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher owner of the app; browser session only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "redirect_uris": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxItems": 5
                  }
                },
                "required": [
                  "redirect_uris"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/media": {
      "get": {
        "operationId": "listMedia",
        "summary": "List an app's uploaded image processing results",
        "description": "Current owner/release_manager of the active publisher organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List an app's uploaded image processing results.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/MediaAsset"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "post": {
        "operationId": "uploadMedia",
        "summary": "Upload an image for isolated AVIF conversion",
        "description": "Current owner/release_manager of the active publisher organization. Raw PNG/JPEG/WebP/AVIF, up to 20 MiB; 32 megapixels and 8192 pixels/side maximum. Queued conversion emits static AVIF 10-bit 4:4:4 quality 60. Icons 512 square; screenshots up to 2560 pixels/side. Raw bytes are never served. At most 40 uploads/hour and 200 retained assets/product.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Upload an image for isolated AVIF conversion.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaAsset"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "kind",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "icon",
                "screenshot"
              ]
            }
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/purchases": {
      "get": {
        "operationId": "publisherPurchases",
        "summary": "List an app's paid purchases for sync",
        "description": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read. Oldest change first (updated_at, then order ID). Store next_cursor and poll with it to receive new and changed purchases; null means you're up to date. Filter by buyer_id to list one buyer's purchases. Webhooks (payment.confirmed, purchase.access_changed, refund.*) announce changes; this feed is the source of truth.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "List an app's paid purchases for sync.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublisherPurchase"
                      }
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "items",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "purchases:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "buyer_id",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "next_cursor from the previous page."
          },
          {
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "oldest",
                "newest"
              ]
            },
            "description": "oldest (default) for sync; newest for a recent-purchases view."
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/purchases/{order}": {
      "get": {
        "operationId": "publisherPurchase",
        "summary": "Read one paid purchase",
        "description": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read. 404 purchase_not_found for unpaid orders and other apps' orders.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read one paid purchase.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherPurchase"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "purchases:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/webhooks": {
      "get": {
        "operationId": "publisherWebhooks",
        "summary": "List app webhook receivers",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. ",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "List app webhook receivers.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublisherWebhook"
                      }
                    },
                    "event_types": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "release.validation_passed",
                          "release.validation_failed",
                          "release.published",
                          "release.withdraw",
                          "release.scheduled",
                          "release.schedule_blocked",
                          "listing.publish",
                          "payment.confirmed",
                          "purchase.access_changed",
                          "refund.approved",
                          "refund.declined",
                          "gift.redeemed",
                          "license_code.redeemed",
                          "license_batch.created",
                          "license_batch.revoked"
                        ]
                      }
                    },
                    "available": {
                      "type": "boolean"
                    },
                    "delivery_enabled": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "items",
                    "event_types",
                    "available",
                    "delivery_enabled"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "post": {
        "operationId": "createWebhook",
        "summary": "Create a webhook receiver",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Up to five enabled / ten saved receivers per app. Public HTTPS only; DNS and destination addresses revalidated and pinned for each attempt. Secret shown once. Creation does not send a message.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a webhook receiver.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSecret"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048
                  },
                  "events": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "release.validation_passed",
                        "release.validation_failed",
                        "release.published",
                        "release.withdraw",
                        "release.scheduled",
                        "release.schedule_blocked",
                        "listing.publish",
                        "payment.confirmed",
                        "purchase.access_changed",
                        "refund.approved",
                        "refund.declined",
                        "gift.redeemed",
                        "license_code.redeemed",
                        "license_batch.created",
                        "license_batch.revoked"
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 15
                  },
                  "enabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "url",
                  "events",
                  "enabled"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}/deliveries": {
      "get": {
        "operationId": "webhookDeliveries",
        "summary": "Read receiver delivery history",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. ",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read receiver delivery history.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "webhook": {
                      "$ref": "#/components/schemas/PublisherWebhook"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WebhookDelivery"
                      }
                    },
                    "limit": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 1
                    },
                    "offset": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "retention_days": {
                      "type": "integer",
                      "const": 30
                    }
                  },
                  "required": [
                    "webhook",
                    "items",
                    "limit",
                    "offset",
                    "has_more",
                    "retention_days"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}/deliveries/{delivery}": {
      "get": {
        "operationId": "webhookDelivery",
        "summary": "Read immutable event payload and delivery attempts",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. ",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read immutable event payload and delivery attempts.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "event_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "webhook_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "type": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "pending",
                        "sending",
                        "delivered",
                        "failed",
                        "canceled"
                      ]
                    },
                    "attempts": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    },
                    "next_attempt_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "delivered_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_error": {
                      "type": "string"
                    },
                    "http_status": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "format": "int64",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "revision": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 1
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "payload": {
                      "$ref": "#/components/schemas/WebhookEvent"
                    },
                    "attempt_history": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WebhookAttempt"
                      }
                    }
                  },
                  "required": [
                    "id",
                    "event_id",
                    "webhook_id",
                    "type",
                    "state",
                    "attempts",
                    "next_attempt_at",
                    "expires_at",
                    "delivered_at",
                    "last_error",
                    "http_status",
                    "revision",
                    "created_at",
                    "payload",
                    "attempt_history"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "delivery",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/releases/{release}": {
      "get": {
        "operationId": "publisherRelease",
        "summary": "Read release status, inspection and publication details",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. The /validation-runs alias returns the same workspace envelope, including validation_runs.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read release status, inspection and publication details.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherRelease"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      },
      "patch": {
        "operationId": "editRelease",
        "summary": "Edit an unpublished release at the expected revision",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. Only draft/uploading/rejected states as permitted by the command. Changes invalidate approval and publisher attestation; published identities/bytes remain immutable.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Edit an unpublished release at the expected revision.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "revision": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 1
                    }
                  },
                  "required": [
                    "revision"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "release": {
                    "$ref": "#/components/schemas/ReleaseInput"
                  }
                },
                "required": [
                  "expected_revision",
                  "release"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/releases/{release}/attestation-payload": {
      "get": {
        "operationId": "attestationPayload",
        "summary": "Read exact bytes for a release provenance signature",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. Sign the returned UTF-8 payload unchanged. It binds product/release revision, source commit and artifact digests. A publisher assertion does not establish a reproducible build or malware clearance.",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read exact bytes for a release provenance signature.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "payload": {
                      "type": "string",
                      "contentMediaType": "application/json",
                      "contentSchema": {
                        "$ref": "#/components/schemas/AttestationPayload"
                      }
                    },
                    "algorithm": {
                      "type": "string",
                      "const": "ed25519"
                    }
                  },
                  "required": [
                    "payload",
                    "algorithm"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "key_id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "source_url",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "source_revision",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/releases/{release}/preflight": {
      "get": {
        "operationId": "releasePreflight",
        "summary": "Review publication readiness and compare release content",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. Defaults to the current head of the same channel/access class, excluding itself. An explicit comparison must be another release of the same app. Reports changed field names and complete before/after publisher declarations and artifact digests. Ready means validated approval and current optional publisher assertion; it does not guarantee future signer/storage/provider availability. Readiness is rechecked at publication.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Review publication readiness and compare release content.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleasePreflight"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "against",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/releases/{release}/validation-runs": {
      "get": {
        "operationId": "releaseValidationRuns",
        "summary": "Read release status, inspection and publication details",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. The /validation-runs alias returns the same workspace envelope, including validation_runs.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read release status, inspection and publication details.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherRelease"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/uploads/{upload}": {
      "get": {
        "operationId": "publisherUpload",
        "summary": "Read upload state and confirmed multipart receipts",
        "description": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read upload state and confirmed multipart receipts.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadStatus"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current member of the active publisher organization. Also accepts a current product-scoped publisher credential with release:read.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": "release:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "upload",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publishers/{publisher}": {
      "get": {
        "operationId": "publisher",
        "summary": "Read a public publisher profile",
        "description": "Anonymous; only public products and public signing identity facts. At most 100 published catalog products for this publisher.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a public publisher profile.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherPage"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous; only public products and public signing identity facts.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "publisher",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Publisher URL slug."
            }
          }
        ]
      }
    },
    "/api/v1/purchase-links/{product}": {
      "get": {
        "operationId": "linkRequest",
        "summary": "Describe a link request for the consent page",
        "description": "Anonymous or signed-in customer. 400 invalid_redirect_uri when the app doesn't list the address; never redirect to it then.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "200": {
            "description": "Describe a link request for the consent page.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LinkRequest"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous or signed-in customer.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "redirect_uri",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/releases/{release}": {
      "get": {
        "operationId": "publicRelease",
        "summary": "Read a visible published release and artifact digests",
        "description": "Current product visibility and release-channel access; listing an official artifact does not authorize paid bytes. ",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a visible published release and artifact digests.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicRelease"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current product visibility and release-channel access; listing an official artifact does not authorize paid bytes.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/releases/{release}/manifest": {
      "get": {
        "operationId": "releaseManifest",
        "summary": "Read installation metadata for a visible release",
        "description": "Product visibility; byte grants remain separate. Manifest bytes are a TUF target. Bootstrap a trusted root, verify metadata and compare target hash/length before interpreting this response. Link points to timestamp metadata.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read installation metadata for a visible release.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "Link": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleaseManifest"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Product visibility; byte grants remain separate.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/stats": {
      "get": {
        "operationId": "storeStatistics",
        "summary": "Read public store download totals and trends",
        "description": "Public aggregates for currently public apps from active publishers. Counts complete artifact transfers once per grant, including completed ranges. Not unique people or installations. UTC daily buckets; collection starts at the returned timestamp. Unknown days values default to 30.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read public store download totals and trends.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreStatistics"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Public aggregates for currently public apps from active publishers.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "30",
                "90",
                "365"
              ]
            }
          }
        ]
      }
    },
    "/delivery/{token}/{filename}": {
      "get": {
        "operationId": "Delivery",
        "summary": "Transfer currently authorized immutable artifact bytes",
        "description": "Short-lived delivery bearer token in the URL path; current actor/entitlement/withdrawal status is rechecked before conditional/range handling. GET and HEAD; 200 full response, 206 single range, 304 unchanged, 416 unsatisfiable range. Renew grants to resume after expiry and verify the final target digest. Direct object origin remains private.",
        "tags": [
          "Distribution"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Transfer currently authorized immutable artifact bytes.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "206": {
            "description": "One authorized byte range.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "304": {
            "description": "Authorized request; artifact unchanged.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "416": {
            "description": "Invalid/unsatisfiable single range.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "4XX": {
            "description": "Denied, expired, revoked, unavailable or malformed delivery request.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Denied, expired, revoked, unavailable or malformed delivery request.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Short-lived delivery bearer token in the URL path; current actor/entitlement/withdrawal status is rechecked before conditional/range handling.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "header",
            "name": "Range",
            "schema": {
              "type": "string"
            },
            "description": "One byte range only, including suffix/open-ended ranges."
          },
          {
            "in": "header",
            "name": "If-None-Match",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "If-Range",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Sensitive delivery bearer capability. Redact the entire URL in logs and traces."
          },
          {
            "in": "path",
            "name": "filename",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      },
      "head": {
        "operationId": "headDelivery",
        "summary": "Read currently authorized artifact headers",
        "description": "Short-lived delivery bearer token in the URL path; current actor/entitlement/withdrawal status is rechecked before conditional/range handling. GET and HEAD; 200 full response, 206 single range, 304 unchanged, 416 unsatisfiable range. Renew grants to resume after expiry and verify the final target digest. Direct object origin remains private.",
        "tags": [
          "Distribution"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Transfer currently authorized immutable artifact bytes.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "206": {
            "description": "One authorized byte range.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "304": {
            "description": "Authorized request; artifact unchanged.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "416": {
            "description": "Invalid/unsatisfiable single range.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "4XX": {
            "description": "Denied, expired, revoked, unavailable or malformed delivery request."
          },
          "default": {
            "description": "Denied, expired, revoked, unavailable or malformed delivery request."
          }
        },
        "x-authorization": {
          "authority": "Short-lived delivery bearer token in the URL path; current actor/entitlement/withdrawal status is rechecked before conditional/range handling.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "header",
            "name": "Range",
            "schema": {
              "type": "string"
            },
            "description": "One byte range only, including suffix/open-ended ranges."
          },
          {
            "in": "header",
            "name": "If-None-Match",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "If-Range",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Sensitive delivery bearer capability. Redact the entire URL in logs and traces."
          },
          {
            "in": "path",
            "name": "filename",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/metadata/{product}/{name}": {
      "get": {
        "operationId": "trustMetadata",
        "summary": "Read a TUF role or authenticated target by name",
        "description": "Public trust namespace when previously published publicly; private trust requires product visibility. A revoked public product retains readable safety metadata. name is a slash-bearing suffix, for example timestamp.json, 2.root.json or targets/manifests/<release>.json. Consistent snapshot hash prefixes select matching historical bytes. Use a maintained TUF client; this API is not a signature-verification service.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read a TUF role or authenticated target by name.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/TUFEnvelope"
                    },
                    {
                      "$ref": "#/components/schemas/ReleaseManifest"
                    },
                    {
                      "$ref": "#/components/schemas/ChannelTarget"
                    },
                    {
                      "$ref": "#/components/schemas/AdvisoryTarget"
                    },
                    {
                      "$ref": "#/components/schemas/PublisherKeysTarget"
                    }
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Public trust namespace when previously published publicly; private trust requires product visibility. A revoked public product retains readable safety metadata.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Slash-bearing metadata suffix. Go decodes encoded slashes in this wildcard value."
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/channel-policies/{channel}/members/{user}": {
      "patch": {
        "operationId": "channelMemberDecision",
        "summary": "Approve, decline or revoke a channel participant",
        "description": "Current owner/release_manager of the active publisher organization. Publisher owner/release manager, scoped to this app. Optimistic participant revision prevents stale decisions; revocation clears the matching account preference.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Approve, decline or revoke a channel participant.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "approved",
                        "rejected",
                        "revoked"
                      ]
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "enum": [
                      "approved",
                      "rejected",
                      "revoked"
                    ]
                  },
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "state",
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/channel-invitations/accept": {
      "post": {
        "operationId": "acceptChannelInvitation",
        "summary": "Accept an invitation to a publisher release channel",
        "description": "Authenticated customer; own resource only. Active customer with the matching verified email. Channel participation only; no purchase, subscription, or publisher role is granted.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Accept an invitation to a publisher release channel.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "product_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "channel": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string",
                      "const": "approved"
                    }
                  },
                  "required": [
                    "product_id",
                    "channel",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "minLength": 64,
                    "maxLength": 64
                  }
                },
                "required": [
                  "token"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/channel-invitations/preview": {
      "post": {
        "operationId": "previewChannelInvitation",
        "summary": "Read the destination of a channel invitation",
        "description": "Browser session and CSRF; possession of a current invitation token. Returns app/publisher/channel identity, not the invited email.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Read the destination of a channel invitation.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChannelInvitationPreview"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Browser session and CSRF; possession of a current invitation token.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "minLength": 64,
                    "maxLength": 64
                  }
                },
                "required": [
                  "token"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/checkouts": {
      "post": {
        "operationId": "createCheckout",
        "summary": "Create or recover a hosted checkout order",
        "description": "Personal billing owner or current organization owner/billing_admin. One first-party test seller, USD offer and billing account. Personal quantity is one; organizations allow up to 1000. Poll the returned order ID; a checkout redirect never grants access. Optional gift=true requires personal quantity 1 and a public/unlisted paid release-family offer. The paid buyer receives a private code, not an entitlement; a single recipient redeems it. Gifts require configured code storage. Subscription gifts are not supported. Native access tokens can create personal and organization checkouts, not gifts (422 gift_browser_only). A native order returns from the hosted page to /checkout/{order}/return, which asks the buyer to go back to the app; it reads no order and proves nothing. The 202 url is the website's checkout page: a native client ignores it, polls the order until checkout_url is set, and opens only that hosted page in the system browser. Persist the Idempotency-Key with the order ID so a retry after a crash or timeout recovers the same order. 409 existing_purchase means another open checkout or purchase covers this option; send the buyer to the website's purchases page. 409 deletion_scheduled means the buyer's account is waiting to be deleted; no new checkout starts until the buyer keeps the account on the website's privacy page.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Create or recover a hosted checkout order.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutResult"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 200
            },
            "description": "Stable opaque key for this actor/command. Same key and normalized body returns the existing result; changed body returns 409. Persist across timeouts; do not generate a new key to guess whether money moved."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckoutInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/download-grants": {
      "post": {
        "operationId": "downloadGrant",
        "summary": "Authorize an exact artifact download",
        "description": "Anonymous native request with no Cookie, Authorization or Origin for public community access; browser session+CSRF otherwise. Official/private access requires a currently entitled customer. Grant lifetime is fifteen minutes. The URL is a bearer capability; do not persist it in logs. Every new delivery request rechecks current channel participation and commercial access. Select artifact_id when multiple variants exist.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Authorize an exact artifact download.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadGrant"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous native request with no Cookie, Authorization or Origin for public community access; browser session+CSRF otherwise. Official/private access requires a currently entitled customer.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DownloadGrantInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/me/entitlement-tokens": {
      "post": {
        "operationId": "entitlementToken",
        "summary": "Issue a signed entitlement token for an app",
        "description": "Authenticated customer (browser session or the Praxical app's native token); own access only. 403 no_entitlement without current access; 503 entitlement_tokens_unavailable where no signing key is configured. The Praxical app requests one on behalf of an installed app and hands it over locally. The publisher's server verifies the signature against entitlementKeys (match kid), then checks iss, aud (its application_id), nbf and exp. access holds the caller's active entries, as in publisherBuyer. Tokens are not revoked: after a refund, dispute, expiry, a seat's organization suspension or the member leaving, no new one is issued, and the last one lapses within 24 hours.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Issue a signed entitlement token for an app.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntitlementToken"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer (browser session or the Praxical app's native token); own access only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product_id": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "required": [
                  "product_id"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/me/license-codes/preview": {
      "post": {
        "operationId": "previewLicenseCode",
        "summary": "Preview the release family offered by a code",
        "description": "Authenticated customer; own resource only. Authenticated active account. Invalid, unavailable and another account's redeemed code return the same 404. Preview and redeem share a persisted per-account budget of ten attempts/minute and thirty/hour, including malformed codes. No buyer or recipient identity is exposed.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Preview the release family offered by a code.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "product_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "product_slug": {
                      "type": "string"
                    },
                    "family_name": {
                      "type": "string"
                    },
                    "family_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "expires_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "already_redeemed": {
                      "type": "boolean"
                    },
                    "terms": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "product_id",
                    "product_name",
                    "product_slug",
                    "family_name",
                    "family_id",
                    "expires_at",
                    "already_redeemed",
                    "terms"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "PRX followed by 32 base32 characters, optionally separated by hyphens. High-entropy bearer value: never put in URLs/logs."
                  }
                },
                "required": [
                  "code"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/me/license-redemptions": {
      "post": {
        "operationId": "redeemLicenseCode",
        "summary": "Request one-account license redemption",
        "description": "Authenticated customer; own resource only. 202 queues an atomic worker transaction; poll the returned request. The worker rechecks app/publisher availability, paid gift state, batch revocation, code expiry and existing personal family ownership. A duplicate existing family returns failed/already_owned without consuming the code. A repeated redemption by its recipient returns the existing entitlement. Subscription codes are not supported.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Request one-account license redemption.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "const": "pending"
                    }
                  },
                  "required": [
                    "id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 200
            },
            "description": "Stable opaque key for this actor/command. Same key and normalized body returns the existing result; changed body returns 409. Persist across timeouts; do not generate a new key to guess whether money moved."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "PRX followed by 32 base32 characters, optionally separated by hyphens. High-entropy bearer value: never put in URLs/logs."
                  }
                },
                "required": [
                  "code"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/me/purchase-links": {
      "post": {
        "operationId": "approveLink",
        "summary": "Approve linking your purchases to a publisher's account",
        "description": "Authenticated customer; browser session only. share_profile grants (true) or withdraws (false) consent to share email and name with the app's publisher. redirect_url is the listed address with code (single use, ten minutes) and state added. To decline, send the buyer to the address with error=access_denied and the state.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Approve linking your purchases to a publisher's account.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "redirect_url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "redirect_url"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; browser session only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "redirect_uri": {
                    "type": "string"
                  },
                  "state": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "share_profile": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "product_id",
                  "redirect_uri",
                  "state",
                  "share_profile"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/orders/{order}/gift-code": {
      "post": {
        "operationId": "giftCode",
        "summary": "Reveal a paid unused gift code",
        "description": "Authenticated customer; own resource only. Authenticated personal buyer, recent MFA, paid/partially refunded order and active unused code. Audited no-store response; never email or share the code automatically.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Reveal a paid unused gift code.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "redeem_path": {
                      "type": "string",
                      "const": "/redeem"
                    }
                  },
                  "required": [
                    "code",
                    "redeem_path"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/orders/{order}/refund-requests": {
      "post": {
        "operationId": "requestRefund",
        "summary": "Request a refund",
        "description": "Personal billing owner or current organization owner/billing_admin. See RefundRequest for the policy. The response says whether the request waits on computers (uninstall_checks), was approved at once (nothing was downloaded) or goes to an operator. 409 refund_request_open when one is already open; 409 refund_unavailable unless the order is paid or partially refunded. Native access tokens can request refunds for the account's orders.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Request a refund.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RefundRequestView"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 200
            },
            "description": "Stable opaque key for this actor/command. Same key and normalized body returns the existing result; changed body returns 409. Persist across timeouts; do not generate a new key to guess whether money moved."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 4000,
                    "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
                  }
                },
                "required": [
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/products/{product}/views": {
      "post": {
        "operationId": "productView",
        "summary": "Record a visible storefront listing view",
        "description": "Browser session and CSRF required; anonymous browsing supported. Deduplicated per browser session/product in a 30-minute bucket; opaque deduplication receipts expire after two days. No raw IP or account ID is recorded. Private listings and publisher/staff previews are excluded. Aggregate page views are not unique people.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {},
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Record a visible storefront listing view.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "recorded": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "recorded"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Browser session and CSRF required; anonymous browsing supported.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/organizations/{organization}/key-challenges": {
      "post": {
        "operationId": "keyChallenge",
        "summary": "Create a five-minute proof-of-key-possession challenge",
        "description": "Active publisher organization owner with recent MFA. ",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a five-minute proof-of-key-possession challenge.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyChallenge"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner with recent MFA.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KeyInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/organizations/{organization}/keys/{key}/revocation": {
      "post": {
        "operationId": "revokePublisherKey",
        "summary": "Revoke a publisher signing identity",
        "description": "Active publisher organization owner with recent MFA. Future attestations/signing are denied; signed publisher-key targets renew. Central TUF signing keys are a separate offline operational boundary.",
        "tags": [
          "Publisher identity"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Revoke a publisher signing identity.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "const": "revoked"
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner with recent MFA.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "organization",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 4000,
                    "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
                  }
                },
                "required": [
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/channel-policies/{channel}/invitations": {
      "post": {
        "operationId": "inviteChannel",
        "summary": "Create a release-channel invitation link",
        "description": "Current owner/release_manager of the active publisher organization. Seven-day token returned once in a URL fragment; email delivery is not automatic. Acceptance requires the matching verified email. At most 100 invitations per channel per day.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a release-channel invitation link.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "url": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "id",
                    "url",
                    "expires_at"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "maxLength": 254
                  }
                },
                "required": [
                  "email"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/families": {
      "post": {
        "operationId": "createFamily",
        "summary": "Create an immutable release family",
        "description": "Current owner/release_manager of the active publisher organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create an immutable release family.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "name"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/license-code-batches/{batch}/codes": {
      "post": {
        "operationId": "revealLicenseBatch",
        "summary": "Download unused codes from a batch",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Audited no-store response. Only active, unexpired and unredeemed codes in an unrevoked batch. Keep downloaded codes private.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Download unused codes from a batch.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "code": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "code"
                        ]
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "batch",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/license-code-batches/{batch}/revoke": {
      "post": {
        "operationId": "revokeLicenseBatch",
        "summary": "Permanently revoke unused batch codes",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Atomic against redemption. Already-redeemed licenses remain active. This does not uninstall apps or contact recipients.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Permanently revoke unused batch codes.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "revoked": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "revoked"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "batch",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/listing-submissions": {
      "post": {
        "operationId": "submitListing",
        "summary": "Publish listing changes or request initial app approval",
        "description": "Current owner/release_manager of the active publisher organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Publish listing changes or request initial app approval.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "approved",
                        "awaiting_review"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/products/{product}/offers": {
      "post": {
        "operationId": "createOffer",
        "summary": "Create a new immutable offer",
        "description": "Current owner/release_manager of the active publisher organization. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a new immutable offer.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OfferInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/purchase-links/exchange": {
      "post": {
        "operationId": "exchangeLink",
        "summary": "Exchange a link code for the buyer",
        "description": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read. From your server, within ten minutes, once; redirect_uri must be the address the code was issued for. 400 invalid_grant otherwise. Store buyer_id against your account. profile is present only with the buyer's consent.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Exchange a link code for the buyer.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublisherBuyer"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Publisher owner of the app (browser session), or a product credential with purchases:read issued by a current owner. Also accepts a current product-scoped publisher credential with purchases:read.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "purchases:read"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "redirect_uri": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "redirect_uri"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/releases": {
      "post": {
        "operationId": "createRelease",
        "summary": "Create an immutable-identity release draft",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create an immutable-identity release draft.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReleaseInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/uploads": {
      "post": {
        "operationId": "createUpload",
        "summary": "Create a digest-bound expiring upload session",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. AppDir only; 1 GiB maximum. Session expires after 30 minutes. S3 uses 8 MiB multipart parts at 16 MiB and above. Upload bytes to the returned destination/headers, not the API JSON endpoint.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create a digest-bound expiring upload session.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadResult"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UploadInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}/deliveries/{delivery}/replay": {
      "post": {
        "operationId": "replayWebhook",
        "summary": "Replay an eligible delivery",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Reuses the same event ID and payload with a new timestamp/signature. Deduplicate webhook-id at the receiver. Limited by seven-day delivery expiry and 24 total attempts. Cannot replay an in-flight delivery.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Replay an eligible delivery.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "const": "pending"
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "delivery",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  }
                },
                "required": [
                  "expected_revision"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}/rotate-secret": {
      "post": {
        "operationId": "rotateWebhookSecret",
        "summary": "Rotate a receiver signing secret",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. During overlap each send contains both current and previous signatures. A further overlapping rotation is rejected until the previous overlap ends; choose 0 hours for immediate replacement, invalidating both prior keys.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Rotate a receiver signing secret.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSecret"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "overlap_hours": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 0,
                    "maximum": 24
                  }
                },
                "required": [
                  "expected_revision",
                  "overlap_hours"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/webhooks/{webhook}/test": {
      "post": {
        "operationId": "testWebhook",
        "summary": "Queue a synthetic webhook.test event",
        "description": "Active publisher organization owner for this product; browser session only, no automation or native bearer. Requires delivery enabled and an enabled receiver. At most 20 synthetic events per receiver/day; uses the real signed delivery path.",
        "tags": [
          "Publisher integrations"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queue a synthetic webhook.test event.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "const": "pending"
                    }
                  },
                  "required": [
                    "id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Active publisher organization owner for this product; browser session only, no automation or native bearer.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "webhook",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/releases/{release}/controls": {
      "post": {
        "operationId": "releaseControl",
        "summary": "Withdraw a release or change rollout/advisory state",
        "description": "Publisher owner/release_manager on publisher route; platform operator on admin route. Recent MFA required. expected_revision is control_revision. Withdrawal blocks delivery immediately; signed metadata renewal follows durably.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Withdraw a release or change rollout/advisory state.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "const": "metadata_pending"
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Publisher owner/release_manager on publisher route; platform operator on admin route. Recent MFA required.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReleaseControl"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/releases/{release}/publish": {
      "post": {
        "operationId": "publishRelease",
        "summary": "Publish an authorized and validated release snapshot",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:publish. Initial app approval enables publisher-controlled updates. The worker binds a passed validation run and submitter to the exact snapshot digest/revision. The signer checks that authorization or a historical independent review, current publisher status, and immutable objects. Poll /operations/{operation}; nothing is public before the final transaction.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Publish an authorized and validated release snapshot.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "const": "publishing"
                    }
                  },
                  "required": [
                    "operation_id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:publish.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:publish"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/releases/{release}/submissions": {
      "post": {
        "operationId": "submitRelease",
        "summary": "Queue isolated validation of a release submission",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queue isolated validation of a release submission.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "const": "validating"
                    }
                  },
                  "required": [
                    "operation_id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "release",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/uploads/{upload}/abort": {
      "post": {
        "operationId": "abortUpload",
        "summary": "Abort an unsealed upload",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Abort an unsealed upload.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "aborted": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "aborted"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "upload",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/uploads/{upload}/complete": {
      "post": {
        "operationId": "completeUpload",
        "summary": "Seal the exact uploaded object version",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. ",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Seal the exact uploaded object version.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sealed": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "sealed"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "upload",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/publisher/uploads/{upload}/parts": {
      "post": {
        "operationId": "multipartPart",
        "summary": "Prepare or confirm an immutable multipart part",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. S3 only. A part is bound to its initial SHA-256. /parts returns a presigned PUT; /parts/confirm verifies the ETag/checksum receipt and requires etag. Complete only after all parts are confirmed.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Prepare or confirm an immutable multipart part.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadResult"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "upload",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/uploads/{upload}/parts/confirm": {
      "post": {
        "operationId": "confirmMultipartPart",
        "summary": "Prepare or confirm an immutable multipart part",
        "description": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write. S3 only. A part is bound to its initial SHA-256. /parts returns a presigned PUT; /parts/confirm verifies the ETag/checksum receipt and requires etag. Complete only after all parts are confirmed.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "PublisherBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Prepare or confirm an immutable multipart part.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadResult"
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization. Also accepts a current product-scoped publisher credential with release:write.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": "release:write"
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "upload",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "etag": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "part_number": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1,
                    "maximum": 128
                  },
                  "sha256": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  }
                },
                "required": [
                  "part_number",
                  "sha256",
                  "etag"
                ],
                "type": "object",
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/recommendations/{recommendation}/reports": {
      "post": {
        "operationId": "reportRecommendation",
        "summary": "Report a public recommendation for moderation",
        "description": "Authenticated customer; own resource only. Active account; not your own recommendation. Ten new reports per day, one per account/recommendation. Duplicate is idempotent; reports do not automatically suppress ratings. Reporters' identities are not exposed in public or moderator responses.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Report a public recommendation for moderation.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "reported": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "reported"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "recommendation",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "category": {
                    "type": "string",
                    "enum": [
                      "spam",
                      "abuse",
                      "off_topic",
                      "privacy",
                      "other"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "maxLength": 2000
                  }
                },
                "required": [
                  "category"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/subscriptions/{subscription}/billing-portal": {
      "post": {
        "operationId": "billingPortal",
        "summary": "Create a short-lived hosted billing portal session",
        "description": "Personal billing owner or current organization owner/billing_admin. ",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Create a short-lived hosted billing portal session.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "url"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "subscription",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ]
      }
    },
    "/api/v1/subscriptions/{subscription}/cancel": {
      "post": {
        "operationId": "cancelSubscription",
        "summary": "Persist cancellation intent",
        "description": "Personal billing owner or current organization owner/billing_admin. Provider confirmation is asynchronous. Already-paid access is preserved until its effective end. Poll subscription/order facts.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Persist cancellation intent.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "state": {
                      "type": "string",
                      "const": "pending"
                    }
                  },
                  "required": [
                    "operation_id",
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Personal billing owner or current organization owner/billing_admin.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "subscription",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 200
            },
            "description": "Stable opaque key for this actor/command. Same key and normalized body returns the existing result; changed body returns 409. Persist across timeouts; do not generate a new key to guess whether money moved."
          }
        ]
      }
    },
    "/api/v1/updates/resolve": {
      "post": {
        "operationId": "resolveUpdates",
        "summary": "Resolve a bounded batch of install/update suggestions",
        "description": "Anonymous native request with no Cookie, Authorization or Origin for public community access; browser session+CSRF otherwise. Official/private access requires a currently entitled customer. 1–50 items, ordered results. An invisible product or request error fails the whole batch. Per-item compatibility/access states use reason. Independently verify TUF and installation requirements before acting.",
        "tags": [
          "Distribution"
        ],
        "security": [
          {},
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Resolve a bounded batch of install/update suggestions.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/UpdateResult"
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Anonymous native request with no Cookie, Authorization or Origin for public community access; browser session+CSRF otherwise. Official/private access requires a currently entitled customer.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/UpdateInput"
                    },
                    "minItems": 1,
                    "maxItems": 50
                  }
                },
                "required": [
                  "items"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/webhooks/stripe": {
      "post": {
        "operationId": "stripeWebhook",
        "summary": "Record a verified Stripe test event",
        "description": "Stripe-Signature over the raw body; test mode and pinned API version required. Up to 1 MiB. Durable deduplication precedes worker processing; provider events trigger retrieval of authoritative facts.",
        "tags": [
          "Commerce"
        ],
        "security": [
          {
            "StripeSignature": []
          }
        ],
        "responses": {
          "200": {
            "description": "Record a verified Stripe test event.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "received": {
                      "type": "boolean",
                      "const": true
                    }
                  },
                  "required": [
                    "received"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Stripe-Signature over the raw body; test mode and pinned API version required.",
          "recent_mfa": false,
          "browser_csrf": false,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "stripe_test configured",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Unmodified Stripe event JSON for the pinned stripe-go API version; verification uses the exact raw body."
              }
            }
          }
        }
      }
    },
    "/api/v1/me/channel-preferences/{product}": {
      "put": {
        "operationId": "selectChannel",
        "summary": "Select the account's default release channel for an app",
        "description": "Authenticated customer; own resource only. Requires current channel access. Explicit resolver input overrides this preference. Commercial entitlement is still required for official builds.",
        "tags": [
          "Catalog"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          },
          {
            "NativeBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Select the account's default release channel for an app.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "channel": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "channel"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Authenticated customer; own resource only.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": true,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel": {
                    "type": "string"
                  }
                },
                "required": [
                  "channel"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/channel-policies/{channel}": {
      "put": {
        "operationId": "saveChannel",
        "summary": "Create a release channel or change its audience",
        "description": "Current owner/release_manager of the active publisher organization. Use expected_revision=0 for a new channel. At most 20 channels per app; stable, beta and nightly are created with each app. Restricting an audience preserves approved participants. Changes affect future delivery requests immediately.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Create a release channel or change its audience.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "revision": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 1
                    }
                  },
                  "required": [
                    "name",
                    "revision"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "audience": {
                    "type": "string",
                    "enum": [
                      "public",
                      "approval",
                      "invite"
                    ]
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 1000
                  },
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 0
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 4000,
                    "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
                  }
                },
                "required": [
                  "audience",
                  "description",
                  "expected_revision",
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/channels/{channel}": {
      "put": {
        "operationId": "moveChannel",
        "summary": "Move a channel using compare-and-swap revision",
        "description": "Current owner/release_manager of the active publisher organization. expected_revision is the current channel revision (zero for no pointer). Moving backwards does not authorize automatic client downgrade.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "202": {
            "description": "Move a channel using compare-and-swap revision.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "const": "metadata_pending"
                    }
                  },
                  "required": [
                    "state"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": true,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "channel",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChannelInput"
              }
            }
          }
        }
      }
    },
    "/api/v1/publisher/products/{product}/listing-draft": {
      "put": {
        "operationId": "editListing",
        "summary": "Replace a listing draft at the expected revision",
        "description": "Current owner/release_manager of the active publisher organization. Public listing remains unchanged until independent approval of this exact draft. Compare the listing_draft revision, not the product's public revision.",
        "tags": [
          "Publishing"
        ],
        "security": [
          {
            "BrowserSession": [],
            "CSRFToken": [],
            "BrowserOrigin": []
          }
        ],
        "responses": {
          "200": {
            "description": "Replace a listing draft at the expected revision.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string"
                },
                "description": "Bounded request correlation identifier."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Private API responses use no-store. Follow delivery/metadata-specific cache policy."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "const": "draft"
                    },
                    "revision": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 1
                    }
                  },
                  "required": [
                    "state",
                    "revision"
                  ]
                }
              }
            }
          },
          "4XX": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Request, identity, authorization, state/conflict, resource/limit or dependency failure. See the error code and X-Request-ID. Ingress/protocol failures can instead be plain text.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-authorization": {
          "authority": "Current owner/release_manager of the active publisher organization.",
          "recent_mfa": false,
          "browser_csrf": true,
          "native_access_token": false,
          "publisher_scope": null
        },
        "x-runtime": "standard",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "listing": {
                    "$ref": "#/components/schemas/ListingInput"
                  }
                },
                "required": [
                  "expected_revision",
                  "listing"
                ],
                "additionalProperties": false
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BrowserOrigin": {
        "type": "apiKey",
        "in": "header",
        "name": "Origin",
        "description": "Browser supplies an exact allowlisted origin on mutations. This is an origin check, not identity."
      },
      "BrowserSession": {
        "type": "apiKey",
        "in": "cookie",
        "name": "__Host-praxical_session",
        "description": "Opaque HttpOnly Secure SameSite=Lax cookie. Local HTTP development uses praxical_session instead. A session can be anonymous; the operation authority still applies."
      },
      "CSRFToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-CSRF-Token",
        "description": "Exact token from GET /api/v1/session, bound to this browser session. Never put it in a URL."
      },
      "NativeBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "OIDC access token",
        "description": "Registered native public client, exact API resource audience, praxical:customer scope, active introspection on every request. No Cookie or Origin header. Limited to the explicit native route allowlist."
      },
      "PublisherBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "psvc_ opaque token",
        "description": "Expiring product credential; issuer must remain an active authorized publisher member. No Cookie or Origin. Operation-specific release scopes are required."
      },
      "StripeSignature": {
        "type": "apiKey",
        "in": "header",
        "name": "Stripe-Signature",
        "description": "Provider timestamp/signature over exact raw request bytes; not a bearer credential."
      }
    },
    "schemas": {
      "AdvisoryTarget": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "generation": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "advisories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "release_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "severity": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                },
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "id",
                "release_id",
                "kind",
                "severity",
                "message",
                "created_at"
              ]
            }
          }
        },
        "required": [
          "schema_version",
          "product_id",
          "generation",
          "advisories"
        ]
      },
      "Artifact": {
        "properties": {
          "architecture": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "size_bytes": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "release_id",
          "format",
          "architecture",
          "filename",
          "sha256",
          "size_bytes",
          "status",
          "created_at"
        ],
        "type": "object"
      },
      "ArtifactInspection": {
        "type": "object",
        "properties": {
          "profile": {
            "type": "string",
            "const": "appdir-tar-gzip-v1"
          },
          "archive_entries": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 20000
          },
          "expanded_bytes": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 2147483648
          },
          "maximum_entries": {
            "type": "integer",
            "const": 20000
          },
          "maximum_expanded_bytes": {
            "type": "integer",
            "const": 2147483648
          },
          "maximum_entry_bytes": {
            "type": "integer",
            "const": 536870912
          }
        },
        "required": [
          "profile",
          "archive_entries",
          "expanded_bytes",
          "maximum_entries",
          "maximum_expanded_bytes",
          "maximum_entry_bytes"
        ]
      },
      "ArtifactSummary": {
        "type": "object",
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "architecture": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "size_bytes": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "format",
          "architecture",
          "filename",
          "sha256",
          "size_bytes"
        ]
      },
      "AttestationInput": {
        "properties": {
          "key_id": {
            "format": "uuid",
            "type": "string"
          },
          "signature": {
            "type": "string",
            "pattern": "^[A-Fa-f0-9]{128}$"
          },
          "source_revision": {
            "type": "string",
            "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$"
          },
          "source_url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          }
        },
        "required": [
          "key_id",
          "source_url",
          "source_revision",
          "signature"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "AttestationPayload": {
        "type": "object",
        "properties": {
          "context": {
            "type": "string",
            "const": "praxical.publisher-release.v1"
          },
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "publisher_id": {
            "type": "string",
            "format": "uuid"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "release_id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "key_id": {
            "type": "string",
            "format": "uuid"
          },
          "source_url": {
            "type": "string"
          },
          "source_revision": {
            "type": "string"
          },
          "artifacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "sha256": {
                  "type": "string"
                },
                "size_bytes": {
                  "format": "int64",
                  "type": "integer"
                },
                "architecture": {
                  "type": "string"
                },
                "format": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "sha256",
                "size_bytes",
                "architecture",
                "format"
              ]
            }
          }
        },
        "required": [
          "context",
          "schema_version",
          "publisher_id",
          "product_id",
          "release_id",
          "revision",
          "key_id",
          "source_url",
          "source_revision",
          "artifacts"
        ]
      },
      "BuyerAccessItem": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "purchase",
              "gift",
              "license_code",
              "organization_seat"
            ]
          },
          "policy": {
            "type": "string",
            "enum": [
              "release_family",
              "distribution_subscription"
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "active": {
            "type": "boolean"
          },
          "starts_at": {
            "type": "string",
            "format": "date-time"
          },
          "ends_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revocation_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "organization_buyer_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "source",
          "policy",
          "family_id",
          "active",
          "starts_at",
          "ends_at",
          "revoked_at",
          "revocation_reason",
          "organization_buyer_id"
        ]
      },
      "BuyerProfile": {
        "type": "object",
        "properties": {
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "email_verified": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "shared_since": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "email",
          "email_verified",
          "name",
          "shared_since"
        ],
        "description": "Present only while the buyer consents to share their email and name with this publisher (given when they link their account). Withdrawal stops future reads; delete what you received if they ask."
      },
      "CatalogProduct": {
        "properties": {
          "accent": {
            "type": "string"
          },
          "application_id": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "downloadable": {
            "type": "boolean"
          },
          "featured": {
            "type": "boolean"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "homepage_url": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_media_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "icon_url": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preview": {
            "type": "boolean"
          },
          "price_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Integer minor currency units. No floating-point money."
          },
          "privacy_url": {
            "type": "string"
          },
          "publisher_name": {
            "type": "string"
          },
          "publisher_slug": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "screenshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Screenshot"
            }
          },
          "slug": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "application_id",
          "organization_id",
          "slug",
          "name",
          "tagline",
          "description",
          "category",
          "icon",
          "accent",
          "license",
          "source_url",
          "homepage_url",
          "support_url",
          "privacy_url",
          "platforms",
          "formats",
          "permissions",
          "features",
          "screenshots",
          "preview",
          "featured",
          "visibility",
          "revision",
          "created_at",
          "updated_at",
          "icon_media_id",
          "icon_url",
          "publisher_name",
          "publisher_slug",
          "price_minor",
          "downloadable"
        ],
        "type": "object"
      },
      "CatalogRelease": {
        "properties": {
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "channel": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "family_id": {
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publication_sequence": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "published_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher_assertion": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublisherAssertion"
              },
              {
                "type": "null"
              }
            ]
          },
          "release_notes": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "rollout_percent": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "withdrawal_reason": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "version",
          "channel",
          "state",
          "access_class",
          "release_notes",
          "compatibility",
          "permissions",
          "revision",
          "publication_sequence",
          "published_at",
          "withdrawal_reason",
          "rollout_percent",
          "publisher_assertion"
        ],
        "type": "object"
      },
      "Channel": {
        "properties": {
          "access_class": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "name",
          "release_id",
          "revision",
          "updated_at",
          "access_class"
        ],
        "type": "object"
      },
      "ChannelInput": {
        "properties": {
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "expected_revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "reason": {
            "type": "string",
            "minLength": 8,
            "maxLength": 4000,
            "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "release_id",
          "access_class",
          "expected_revision",
          "reason"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "ChannelInvitation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "email": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "pending",
              "accepted",
              "revoked",
              "expired"
            ]
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "email",
          "state",
          "expires_at"
        ]
      },
      "ChannelInvitationPreview": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "publisher_name": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "product_id",
          "product_name",
          "product_slug",
          "publisher_name",
          "channel",
          "expires_at"
        ]
      },
      "ChannelParticipant": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "format": "uuid"
          },
          "display_name": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "revoked",
              "left"
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "requested_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "user_id",
          "display_name",
          "email",
          "state",
          "revision",
          "requested_at"
        ]
      },
      "ChannelPolicy": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "audience": {
            "type": "string",
            "enum": [
              "public",
              "approval",
              "invite"
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelParticipant"
            }
          },
          "invitations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelInvitation"
            }
          }
        },
        "required": [
          "product_id",
          "name",
          "description",
          "audience",
          "revision",
          "created_at",
          "updated_at",
          "members",
          "invitations"
        ]
      },
      "ChannelTarget": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "generation": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "available": {
            "type": "boolean"
          },
          "channels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "channel": {
                  "type": "string"
                },
                "access_class": {
                  "type": "string",
                  "enum": [
                    "community",
                    "official"
                  ]
                },
                "release_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "revision": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 1
                },
                "rollout_percent": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 100
                }
              },
              "required": [
                "channel",
                "access_class",
                "release_id",
                "revision",
                "rollout_percent"
              ]
            }
          }
        },
        "required": [
          "schema_version",
          "product_id",
          "generation",
          "available",
          "channels"
        ]
      },
      "CheckoutInput": {
        "properties": {
          "accept_terms": {
            "type": "boolean",
            "const": true
          },
          "embed_origin": {
            "type": "string"
          },
          "gift": {
            "type": "boolean"
          },
          "offer_id": {
            "format": "uuid",
            "type": "string"
          },
          "organization_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "quantity": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 1000
          }
        },
        "required": [
          "offer_id",
          "quantity",
          "accept_terms"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "CheckoutResult": {
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "url"
        ],
        "type": "object"
      },
      "Compatibility": {
        "type": "object",
        "properties": {
          "schema": {
            "type": "integer",
            "const": 1
          },
          "baseline": {
            "type": "string",
            "minLength": 8,
            "maxLength": 1000,
            "description": "The systems the build is meant for, in the publisher's words. Shown to people."
          },
          "requires": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "maxItems": 10,
            "description": "Other things the app needs, as short phrases (for example `web browser`). Shown to people as not checked by the store; never blocks installation."
          },
          "devices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 0,
            "description": "Reserved. Always empty in schema 1."
          },
          "critical": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 0,
            "description": "Keys a client must understand to install this release. Schema 1 defines none, so it is always empty."
          }
        },
        "required": [
          "baseline"
        ],
        "description": "Compatibility declaration (schema 1), limited to 32 KiB encoded JSON. The publisher writes baseline and requires; the store validates the declaration on save and stores and signs the canonical form with schema, baseline, requires, devices and critical all present. The package runtime is not a publisher field: it is the artifact profile named by the manifest's update_policy.minimum_client_capability (appdir-v1). Clients must refuse installation when schema is unknown or when critical names a key they do not implement; other unknown keys are ignored. Manifests signed before schema 1 have no schema key and may carry baseline with runtime (appdir-v1), requires, devices ([]), runtime_requirements ([]), tested_hosts ([]) or profile (appdir-v1); see BEHAVIOR.md. Input also accepts those legacy keys when they carry no information, and drops them.",
        "additionalProperties": true
      },
      "CredentialInput": {
        "properties": {
          "days": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 90
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "release:read",
                "release:write",
                "release:publish",
                "purchases:read"
              ]
            },
            "maxItems": 4,
            "description": "release:read is always included; duplicates are collapsed. purchases:read reads buyers' purchases and works only while the issuing user is a publisher owner."
          }
        },
        "required": [
          "name",
          "days"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "DownloadGrant": {
        "properties": {
          "artifact_id": {
            "format": "uuid",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "size_bytes": {
            "format": "int64",
            "type": "integer"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "artifact_id",
          "sha256",
          "size_bytes",
          "expires_at"
        ],
        "type": "object"
      },
      "DownloadGrantInput": {
        "properties": {
          "architecture": {
            "type": "string",
            "enum": [
              "x86_64",
              "aarch64"
            ]
          },
          "artifact_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "format": {
            "type": "string",
            "enum": [
              "appdir",
              "appimage",
              "flatpak"
            ]
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "release_id"
        ],
        "type": "object",
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "format": "uuid"
              }
            }
          },
          {
            "required": [
              "architecture",
              "format"
            ]
          }
        ]
      },
      "EmbedOffer": {
        "type": "object",
        "properties": {
          "offer": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "name": {
                "type": "string"
              },
              "policy": {
                "type": "string",
                "enum": [
                  "release_family",
                  "distribution_subscription"
                ]
              },
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "description": "Integer minor currency units. No floating-point money."
              },
              "currency": {
                "type": "string"
              },
              "billing_interval": {
                "type": "string"
              },
              "product_id": {
                "type": "string",
                "format": "uuid"
              },
              "product_name": {
                "type": "string"
              },
              "product_slug": {
                "type": "string"
              },
              "tagline": {
                "type": "string"
              },
              "icon": {
                "type": "string"
              },
              "icon_url": {
                "type": "string"
              },
              "accent": {
                "type": "string"
              },
              "seller_name": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "policy",
              "amount_minor",
              "currency",
              "billing_interval",
              "product_id",
              "product_name",
              "product_slug",
              "tagline",
              "icon",
              "icon_url",
              "accent",
              "seller_name"
            ]
          },
          "frame_ancestors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "purchase_url": {
            "type": "string"
          }
        },
        "required": [
          "offer",
          "frame_ancestors",
          "purchase_url"
        ]
      },
      "EmbedSettings": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "visibility": {
            "type": "string"
          },
          "script_url": {
            "type": "string"
          },
          "origins": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "origin": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "required": [
                "origin",
                "created_at"
              ]
            }
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "name": {
                  "type": "string"
                },
                "policy": {
                  "type": "string",
                  "enum": [
                    "release_family",
                    "distribution_subscription"
                  ]
                },
                "amount_minor": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Integer minor currency units. No floating-point money."
                },
                "currency": {
                  "type": "string"
                },
                "billing_interval": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name",
                "policy",
                "amount_minor",
                "currency",
                "billing_interval"
              ]
            }
          }
        },
        "required": [
          "product_id",
          "visibility",
          "script_url",
          "origins",
          "offers"
        ]
      },
      "Entitlement": {
        "properties": {
          "code_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "order_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "organization_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "policy_snapshot": {
            "type": "object",
            "additionalProperties": true
          },
          "policy_version": {
            "format": "int64",
            "type": "integer"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "revocation_reason": {
            "type": "string"
          },
          "revoked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "seat_count": {
            "format": "int64",
            "type": "integer"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "subscription_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "user_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "user_id",
          "organization_id",
          "product_id",
          "order_id",
          "subscription_id",
          "family_id",
          "policy",
          "policy_version",
          "policy_snapshot",
          "starts_at",
          "ends_at",
          "revoked_at",
          "revocation_reason",
          "seat_count",
          "created_at",
          "code_id"
        ],
        "type": "object"
      },
      "EntitlementToken": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "description": "A compact JWS (EdDSA, typ praxical-entitlement+jwt). Claims: iss (the Store origin), sub (buyer_id), aud (the app's application_id), iat, nbf, exp (24 hours), jti, product_id, access (BuyerAccessItem list, current entries only). Pass it to the app's publisher; do not log it."
          },
          "buyer_id": {
            "type": "string",
            "format": "uuid"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "access": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BuyerAccessItem"
            }
          }
        },
        "required": [
          "token",
          "buyer_id",
          "expires_at",
          "access"
        ]
      },
      "EntitlementView": {
        "properties": {
          "code_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "order_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "organization_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "policy_snapshot": {
            "type": "object",
            "additionalProperties": true
          },
          "policy_version": {
            "format": "int64",
            "type": "integer"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "revocation_reason": {
            "type": "string"
          },
          "revoked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "seat_count": {
            "format": "int64",
            "type": "integer"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "subscription_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "user_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "active": {
            "type": "boolean"
          },
          "assigned": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "user_id",
          "organization_id",
          "product_id",
          "order_id",
          "subscription_id",
          "family_id",
          "policy",
          "policy_version",
          "policy_snapshot",
          "starts_at",
          "ends_at",
          "revoked_at",
          "revocation_reason",
          "seat_count",
          "created_at",
          "code_id",
          "active",
          "assigned",
          "product_name"
        ],
        "type": "object"
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ],
        "description": "Stable machine code and safe user-facing message. Correlate with X-Request-ID; do not parse message text. Edge/protocol errors can have a non-JSON body."
      },
      "GiftCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "family_id": {
            "type": "string",
            "format": "uuid"
          },
          "batch_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "order_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "active",
              "redeemed",
              "suspended",
              "void",
              "expired"
            ]
          },
          "redeemed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "family_name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "batch_id",
          "order_id",
          "state",
          "redeemed_at",
          "expires_at",
          "revision",
          "created_at",
          "product_name",
          "product_slug",
          "family_name"
        ]
      },
      "InvoiceReceipt": {
        "properties": {
          "amount_minor": {
            "format": "int64",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "paid_at": {
            "format": "date-time",
            "type": "string"
          },
          "period_end": {
            "format": "date-time",
            "type": "string"
          },
          "period_start": {
            "format": "date-time",
            "type": "string"
          },
          "provider_id": {
            "type": "string"
          },
          "subscription_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "provider_id",
          "subscription_id",
          "amount_minor",
          "currency",
          "period_start",
          "period_end",
          "paid_at",
          "created_at"
        ],
        "type": "object"
      },
      "JSONWebKeySet": {
        "type": "object",
        "properties": {
          "keys": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kty": {
                  "type": "string",
                  "const": "OKP"
                },
                "crv": {
                  "type": "string",
                  "const": "Ed25519"
                },
                "x": {
                  "type": "string"
                },
                "kid": {
                  "type": "string"
                },
                "alg": {
                  "type": "string",
                  "const": "EdDSA"
                },
                "use": {
                  "type": "string",
                  "const": "sig"
                }
              },
              "required": [
                "kty",
                "crv",
                "x",
                "kid",
                "alg",
                "use"
              ]
            }
          }
        },
        "required": [
          "keys"
        ]
      },
      "KeyChallenge": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "payload": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "payload",
          "expires_at"
        ],
        "type": "object"
      },
      "KeyInput": {
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "public_key": {
            "type": "string",
            "pattern": "^[A-Fa-f0-9]{64}$"
          }
        },
        "required": [
          "name",
          "public_key"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "LicenseBatch": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "organization_id": {
            "type": "string",
            "format": "uuid"
          },
          "family_id": {
            "type": "string",
            "format": "uuid"
          },
          "issued_by": {
            "type": "string",
            "format": "uuid"
          },
          "label": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "policy_snapshot": {
            "type": "object",
            "additionalProperties": true
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "family_name": {
            "type": "string"
          },
          "redeemed_count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "available_count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "product_id",
          "organization_id",
          "family_id",
          "issued_by",
          "label",
          "quantity",
          "policy_snapshot",
          "expires_at",
          "revoked_at",
          "revision",
          "created_at",
          "family_name",
          "redeemed_count",
          "available_count"
        ]
      },
      "LicenseRedemption": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "error": {
            "type": "string"
          },
          "entitlement_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "state",
          "error",
          "entitlement_id",
          "created_at",
          "completed_at",
          "product_id",
          "product_name",
          "product_slug"
        ]
      },
      "LinkRequest": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "publisher_id": {
            "type": "string",
            "format": "uuid"
          },
          "publisher_name": {
            "type": "string"
          },
          "redirect_uri": {
            "type": "string"
          },
          "profile_shared": {
            "type": "boolean"
          }
        },
        "required": [
          "product_id",
          "product_name",
          "product_slug",
          "icon",
          "icon_url",
          "accent",
          "publisher_id",
          "publisher_name",
          "redirect_uri",
          "profile_shared"
        ]
      },
      "LinkSettings": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "authorize_url": {
            "type": "string"
          },
          "redirect_uris": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "redirect_uri": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "required": [
                "redirect_uri",
                "created_at"
              ]
            }
          }
        },
        "required": [
          "product_id",
          "authorize_url",
          "redirect_uris"
        ]
      },
      "ListingDraft": {
        "properties": {
          "content": {
            "$ref": "#/components/schemas/ListingInput"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "updated_by": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "revision",
          "state",
          "content",
          "updated_by",
          "updated_at"
        ],
        "type": "object"
      },
      "ListingInput": {
        "properties": {
          "accent": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "jade",
                  "coral",
                  "lilac",
                  "gold",
                  "blue",
                  "rose"
                ]
              },
              {
                "type": "string",
                "pattern": "^#[0-9a-fA-F]{6}$"
              }
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "productivity",
              "creativity",
              "audio-video",
              "development",
              "utilities",
              "games",
              "education"
            ]
          },
          "description": {
            "type": "string",
            "minLength": 20,
            "maxLength": 20000
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "maxItems": 20
          },
          "homepage_url": {
            "type": "string"
          },
          "icon": {
            "type": "string",
            "enum": [
              "app",
              "folium",
              "frame",
              "sonora",
              "mosaic",
              "orbit",
              "workbench",
              "tidy",
              "worlds"
            ]
          },
          "icon_media_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "license": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PermissionInput"
            },
            "maxItems": 30
          },
          "privacy_url": {
            "type": "string"
          },
          "screenshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MediaReference"
            },
            "maxItems": 10
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "tagline": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "visibility": {
            "type": "string",
            "enum": [
              "public",
              "unlisted",
              "private"
            ]
          }
        },
        "required": [
          "name",
          "tagline",
          "description",
          "category",
          "accent",
          "icon",
          "visibility",
          "license"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "ManifestArtifact": {
        "type": "object",
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "architecture": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "size_bytes": {
            "format": "int64",
            "type": "integer"
          },
          "target": {
            "type": "string",
            "pattern": "^artifacts/[a-f0-9]{64}$"
          },
          "inspection": {
            "$ref": "#/components/schemas/ArtifactInspection"
          }
        },
        "required": [
          "id",
          "format",
          "architecture",
          "filename",
          "sha256",
          "size_bytes",
          "target"
        ]
      },
      "MediaAsset": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "height": {
            "format": "int64",
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "icon",
              "screenshot"
            ]
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "size_bytes": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string",
            "enum": [
              "queued",
              "encoding",
              "ready",
              "failed"
            ]
          },
          "url": {
            "type": "string"
          },
          "width": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "product_id",
          "kind",
          "state",
          "url",
          "width",
          "height",
          "size_bytes",
          "sha256",
          "error",
          "created_at"
        ],
        "type": "object"
      },
      "MediaReference": {
        "properties": {
          "alt": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "media_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "media_id",
          "alt"
        ],
        "type": "object"
      },
      "MyRecommendation": {
        "type": "object",
        "properties": {
          "eligibility": {
            "type": "string",
            "enum": [
              "eligible",
              "account_inactive",
              "staff_affiliation",
              "publisher_affiliation",
              "acquisition_required"
            ]
          },
          "recommendation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OwnRecommendation"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "eligibility",
          "recommendation"
        ]
      },
      "Offer": {
        "properties": {
          "active": {
            "type": "boolean"
          },
          "amount_minor": {
            "format": "int64",
            "type": "integer"
          },
          "billing_interval": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "family_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "policy_version": {
            "format": "int64",
            "type": "integer"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "stripe_price_id": {
            "type": "string"
          },
          "terms": {
            "type": "object",
            "description": "Immutable terms for this policy version; preserve the snapshot and display material conditions.",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "name",
          "policy",
          "policy_version",
          "amount_minor",
          "currency",
          "billing_interval",
          "terms",
          "stripe_price_id",
          "active",
          "created_at"
        ],
        "type": "object"
      },
      "OfferDetail": {
        "properties": {
          "active": {
            "type": "boolean"
          },
          "amount_minor": {
            "format": "int64",
            "type": "integer"
          },
          "billing_interval": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "family_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "policy_version": {
            "format": "int64",
            "type": "integer"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "stripe_price_id": {
            "type": "string"
          },
          "terms": {
            "type": "object",
            "description": "Immutable terms for this policy version; preserve the snapshot and display material conditions.",
            "additionalProperties": true
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "seller_name": {
            "type": "string"
          },
          "preview": {
            "type": "boolean"
          },
          "visibility": {
            "type": "string"
          },
          "eligible_organization_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "name",
          "policy",
          "policy_version",
          "amount_minor",
          "currency",
          "billing_interval",
          "terms",
          "stripe_price_id",
          "active",
          "created_at",
          "product_name",
          "product_slug",
          "icon",
          "icon_url",
          "accent",
          "seller_name",
          "preview",
          "visibility",
          "eligible_organization_ids"
        ],
        "type": "object"
      },
      "OfferInput": {
        "properties": {
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 10000000
          },
          "billing_interval": {
            "type": "string",
            "enum": [
              "once",
              "month",
              "year"
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "replace_offer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "name",
          "policy",
          "amount_minor",
          "billing_interval"
        ],
        "type": "object",
        "additionalProperties": false,
        "description": "USD only. Free is zero/once/no family. Release-family is positive/once with a family belonging to this product. Distribution subscription is positive/month-or-year/no family. Paid offers require the enabled first-party preview seller. Optional replace_offer_id atomically retires an active offer on the same product, preserving existing orders and subscriptions."
      },
      "Order": {
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "amount_minor": {
            "format": "int64",
            "type": "integer"
          },
          "billing_account_id": {
            "format": "uuid",
            "type": "string"
          },
          "buyer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "checkout_client": {
            "type": "string",
            "enum": [
              "web",
              "native",
              "embed"
            ]
          },
          "checkout_url": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "embed_origin": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_snapshot": {},
          "paid_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "payment_mode": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publisher_id": {
            "format": "uuid",
            "type": "string"
          },
          "purchase_kind": {
            "type": "string"
          },
          "quantity": {
            "format": "int64",
            "type": "integer"
          },
          "refunded_minor": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "organization_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "billing_account_id",
          "actor_id",
          "product_id",
          "publisher_id",
          "offer_id",
          "quantity",
          "offer_snapshot",
          "amount_minor",
          "currency",
          "state",
          "payment_mode",
          "checkout_url",
          "paid_at",
          "refunded_minor",
          "created_at",
          "updated_at",
          "purchase_kind",
          "checkout_client",
          "buyer_id",
          "embed_origin",
          "product_name",
          "product_slug",
          "icon",
          "icon_url",
          "accent",
          "organization_name"
        ],
        "type": "object",
        "description": "Immutable offer_snapshot contains the accepted terms. checkout_url is buyer-scoped navigation, not payment confirmation. checkout_client records where the hosted page returns the buyer (native: a page that sends them back to the app); it grants nothing. Billing access is personal ownership or current organization owner/billing_admin membership."
      },
      "OrderDetail": {
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "amount_minor": {
            "format": "int64",
            "type": "integer"
          },
          "billing_account_id": {
            "format": "uuid",
            "type": "string"
          },
          "buyer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "checkout_client": {
            "type": "string",
            "enum": [
              "web",
              "native",
              "embed"
            ]
          },
          "checkout_url": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "embed_origin": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_snapshot": {},
          "paid_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "payment_mode": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publisher_id": {
            "format": "uuid",
            "type": "string"
          },
          "purchase_kind": {
            "type": "string"
          },
          "quantity": {
            "format": "int64",
            "type": "integer"
          },
          "refunded_minor": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "organization_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "subscription": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Subscription"
              },
              {
                "type": "null"
              }
            ]
          },
          "entitlement": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Entitlement"
              },
              {
                "type": "null"
              }
            ]
          },
          "refund_requests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RefundRequestView"
            }
          },
          "invoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InvoiceReceipt"
            }
          },
          "operations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentOperation"
            }
          },
          "gift": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "state": {
                    "type": "string",
                    "enum": [
                      "active",
                      "redeemed",
                      "suspended",
                      "void"
                    ]
                  },
                  "redeemed_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "expires_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "state",
                  "redeemed_at",
                  "expires_at"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "billing_account_id",
          "actor_id",
          "product_id",
          "publisher_id",
          "offer_id",
          "quantity",
          "offer_snapshot",
          "amount_minor",
          "currency",
          "state",
          "payment_mode",
          "checkout_url",
          "paid_at",
          "refunded_minor",
          "created_at",
          "updated_at",
          "purchase_kind",
          "checkout_client",
          "buyer_id",
          "embed_origin",
          "product_name",
          "product_slug",
          "icon",
          "icon_url",
          "accent",
          "organization_name",
          "subscription",
          "entitlement",
          "refund_requests",
          "invoices",
          "operations",
          "gift"
        ],
        "type": "object",
        "description": "Immutable offer_snapshot contains the accepted terms. checkout_url is buyer-scoped navigation, not payment confirmation. checkout_client records where the hosted page returns the buyer (native: a page that sends them back to the app); it grants nothing. Billing access is personal ownership or current organization owner/billing_admin membership."
      },
      "OwnRecommendation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "recommended": {
            "type": "boolean"
          },
          "body": {
            "type": "string",
            "maxLength": 4000
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "hidden": {
            "type": "boolean"
          },
          "hidden_reason": {
            "type": "string"
          },
          "deleted": {
            "type": "boolean"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "recommended",
          "body",
          "revision",
          "hidden",
          "hidden_reason",
          "deleted",
          "updated_at"
        ]
      },
      "PartInput": {
        "properties": {
          "etag": {
            "type": "string",
            "maxLength": 200
          },
          "part_number": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 128
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "part_number",
          "sha256"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "PaymentOperation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "action",
          "state",
          "error"
        ]
      },
      "PendingUpload": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "architecture": {
            "type": "string",
            "enum": [
              "x86_64",
              "aarch64"
            ]
          },
          "filename": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "architecture",
          "filename",
          "state",
          "expires_at"
        ]
      },
      "Permission": {
        "properties": {
          "description": {
            "type": "string",
            "minLength": 8,
            "maxLength": 1000
          },
          "level": {
            "type": "string",
            "enum": [
              "standard",
              "sensitive",
              "optional",
              "unknown"
            ]
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "name",
          "description"
        ],
        "type": "object",
        "description": "Older immutable fixture releases may omit level. Treat an undeclared level as unknown. New release/listing submissions require an explicit level."
      },
      "PermissionInput": {
        "properties": {
          "description": {
            "type": "string",
            "minLength": 8,
            "maxLength": 1000
          },
          "level": {
            "type": "string",
            "enum": [
              "standard",
              "sensitive",
              "optional",
              "unknown"
            ]
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "name",
          "description",
          "level"
        ],
        "type": "object"
      },
      "PlacementCard": {
        "properties": {
          "accent": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "image_url": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "staff_pick",
              "sponsored"
            ]
          },
          "name": {
            "type": "string"
          },
          "preview": {
            "type": "boolean"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publisher_name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "kind",
          "title",
          "description",
          "slug",
          "name",
          "publisher_name",
          "icon",
          "icon_url",
          "image_url",
          "accent",
          "preview"
        ],
        "type": "object"
      },
      "ProductAccess": {
        "type": "object",
        "properties": {
          "policy": {
            "type": "string",
            "enum": [
              "free",
              "release_family",
              "distribution_subscription"
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "ends_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "organization_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "policy",
          "family_id",
          "ends_at",
          "organization_id"
        ]
      },
      "ProductChannels": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicChannel"
            }
          },
          "selected": {
            "type": "string"
          }
        },
        "required": [
          "items",
          "selected"
        ]
      },
      "ProductDetail": {
        "properties": {
          "accent": {
            "type": "string"
          },
          "access": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductAccess"
            }
          },
          "application_id": {
            "type": "string"
          },
          "can_manage": {
            "type": "boolean"
          },
          "category": {
            "type": "string"
          },
          "claimed": {
            "type": "boolean"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "downloadable": {
            "type": "boolean"
          },
          "featured": {
            "type": "boolean"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "homepage_url": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_media_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "icon_url": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "offers": {
            "items": {
              "$ref": "#/components/schemas/Offer"
            },
            "type": "array"
          },
          "organization_id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preview": {
            "type": "boolean"
          },
          "price_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Integer minor currency units. No floating-point money."
          },
          "privacy_url": {
            "type": "string"
          },
          "publisher_name": {
            "type": "string"
          },
          "publisher_slug": {
            "type": "string"
          },
          "releases": {
            "items": {
              "$ref": "#/components/schemas/CatalogRelease"
            },
            "type": "array"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "saved": {
            "type": "boolean"
          },
          "screenshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Screenshot"
            }
          },
          "slug": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "application_id",
          "organization_id",
          "slug",
          "name",
          "tagline",
          "description",
          "category",
          "icon",
          "accent",
          "license",
          "source_url",
          "homepage_url",
          "support_url",
          "privacy_url",
          "platforms",
          "formats",
          "permissions",
          "features",
          "screenshots",
          "preview",
          "featured",
          "visibility",
          "revision",
          "created_at",
          "updated_at",
          "icon_media_id",
          "icon_url",
          "publisher_name",
          "publisher_slug",
          "price_minor",
          "downloadable",
          "offers",
          "releases",
          "can_manage",
          "claimed",
          "saved",
          "access"
        ],
        "type": "object"
      },
      "ProductPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogProduct"
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "limit": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 10000
          }
        },
        "required": [
          "items",
          "has_more",
          "limit",
          "offset"
        ]
      },
      "ProductStatistics": {
        "properties": {
          "bytes": {
            "format": "int64",
            "type": "integer"
          },
          "collection_started_at": {
            "format": "date-time",
            "type": "string"
          },
          "downloads": {
            "format": "int64",
            "type": "integer"
          },
          "previous_week": {
            "format": "int64",
            "type": "integer"
          },
          "timeline": {
            "items": {
              "properties": {
                "bytes": {
                  "format": "int64",
                  "type": "integer"
                },
                "day": {
                  "type": "string"
                },
                "downloads": {
                  "format": "int64",
                  "type": "integer"
                }
              },
              "required": [
                "day",
                "downloads",
                "bytes"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "week": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "collection_started_at",
          "downloads",
          "bytes",
          "week",
          "previous_week",
          "timeline"
        ],
        "type": "object"
      },
      "PublicChannel": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "audience": {
            "type": "string",
            "enum": [
              "public",
              "approval",
              "invite"
            ]
          },
          "allowed": {
            "type": "boolean"
          },
          "membership": {
            "type": "string",
            "enum": [
              "none",
              "pending",
              "approved",
              "rejected",
              "revoked",
              "left"
            ]
          },
          "available": {
            "type": "boolean"
          },
          "heads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "release_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "access_class": {
                  "type": "string",
                  "enum": [
                    "community",
                    "official"
                  ]
                },
                "version": {
                  "type": "string"
                },
                "publication_sequence": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 1
                }
              },
              "required": [
                "release_id",
                "access_class",
                "version",
                "publication_sequence"
              ]
            }
          }
        },
        "required": [
          "name",
          "description",
          "audience",
          "allowed",
          "membership",
          "available",
          "heads"
        ]
      },
      "PublicPublisherKey": {
        "type": "object",
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "public_key": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "revoked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "revocation_reason": {
            "type": "string"
          },
          "algorithm": {
            "type": "string",
            "const": "ed25519"
          }
        },
        "required": [
          "id",
          "name",
          "public_key",
          "fingerprint",
          "created_at",
          "revoked_at",
          "revocation_reason",
          "algorithm"
        ]
      },
      "PublicRelease": {
        "type": "object",
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "family_id": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "release_notes": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "publication_sequence": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "published_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "withdrawal_reason": {
            "type": "string"
          },
          "artifacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ArtifactSummary"
            }
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "version",
          "channel",
          "state",
          "access_class",
          "release_notes",
          "compatibility",
          "permissions",
          "publication_sequence",
          "published_at",
          "withdrawal_reason",
          "artifacts"
        ]
      },
      "PublicationRun": {
        "properties": {
          "approved_digest": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "sequence": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "release_id",
          "sequence",
          "approved_digest",
          "state",
          "error",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "PublicationSchedule": {
        "type": "object",
        "properties": {
          "release_id": {
            "type": "string",
            "format": "uuid"
          },
          "scheduled_by": {
            "type": "string",
            "format": "uuid"
          },
          "publish_at": {
            "type": "string",
            "format": "date-time"
          },
          "release_revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "state": {
            "type": "string",
            "enum": [
              "scheduled",
              "queued",
              "canceled",
              "blocked"
            ]
          },
          "error": {
            "type": "string"
          },
          "operation_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "reason": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "release_id",
          "scheduled_by",
          "publish_at",
          "release_revision",
          "revision",
          "state",
          "error",
          "operation_id",
          "reason",
          "created_at",
          "updated_at"
        ]
      },
      "Publisher": {
        "properties": {
          "about": {
            "type": "string"
          },
          "avatar": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "preview": {
            "type": "boolean"
          },
          "slug": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "website": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "about",
          "website",
          "support_url",
          "source_url",
          "location",
          "verified_at",
          "avatar",
          "preview"
        ],
        "type": "object"
      },
      "PublisherAssertion": {
        "type": "object",
        "properties": {
          "scheme": {
            "type": "string",
            "const": "ed25519-praxical-release-v1"
          },
          "key_id": {
            "type": "string",
            "format": "uuid"
          },
          "public_key": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "fingerprint": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "payload": {
            "type": "string"
          },
          "signature": {
            "type": "string",
            "pattern": "^[a-f0-9]{128}$"
          },
          "verification": {
            "type": "string",
            "const": "publisher-assertion"
          },
          "reproducible_build_verified": {
            "type": "boolean",
            "const": false
          }
        },
        "required": [
          "scheme",
          "key_id",
          "public_key",
          "fingerprint",
          "payload",
          "signature",
          "verification",
          "reproducible_build_verified"
        ]
      },
      "PublisherBuyer": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": "string",
            "format": "uuid"
          },
          "buyer_kind": {
            "type": "string",
            "enum": [
              "user",
              "organization"
            ]
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "active": {
            "type": "boolean"
          },
          "access": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BuyerAccessItem"
            }
          },
          "purchases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublisherPurchase"
            }
          },
          "profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BuyerProfile"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "buyer_id",
          "buyer_kind",
          "product_id",
          "active",
          "access",
          "purchases",
          "profile"
        ]
      },
      "PublisherCredential": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "issued_by": {
            "format": "uuid",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "revoked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "scopes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "id",
          "organization_id",
          "product_id",
          "issued_by",
          "name",
          "scopes",
          "expires_at",
          "revoked_at",
          "last_used_at",
          "created_at"
        ],
        "type": "object"
      },
      "PublisherKeysTarget": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "generation": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicPublisherKey"
            }
          }
        },
        "required": [
          "schema_version",
          "product_id",
          "generation",
          "keys"
        ]
      },
      "PublisherOrganization": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "slug": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "owner",
              "release_manager",
              "finance_viewer",
              "billing_admin",
              "seat_admin",
              "member"
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "kind",
          "status",
          "created_at",
          "revision",
          "role"
        ],
        "type": "object"
      },
      "PublisherPage": {
        "type": "object",
        "properties": {
          "publisher": {
            "$ref": "#/components/schemas/Publisher"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogProduct"
            }
          },
          "signing_keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicPublisherKey"
            }
          }
        },
        "required": [
          "publisher",
          "products",
          "signing_keys"
        ]
      },
      "PublisherProduct": {
        "properties": {
          "accent": {
            "type": "string"
          },
          "application_id": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "featured": {
            "type": "boolean"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "homepage_url": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_media_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preview": {
            "type": "boolean"
          },
          "privacy_url": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "screenshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Screenshot"
            }
          },
          "slug": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "trust_dirty": {
            "type": "boolean"
          },
          "trust_public": {
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "initial_approved": {
            "type": "boolean"
          },
          "listing_draft": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ListingDraft"
              },
              {
                "type": "null"
              }
            ]
          },
          "private_access": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "organization_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "organization_id",
                "name"
              ]
            }
          },
          "families": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReleaseFamily"
            }
          },
          "offers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Offer"
            }
          },
          "releases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublisherReleaseSummary"
            }
          },
          "channels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Channel"
            }
          }
        },
        "required": [
          "id",
          "organization_id",
          "slug",
          "name",
          "tagline",
          "description",
          "category",
          "icon",
          "accent",
          "license",
          "source_url",
          "homepage_url",
          "support_url",
          "privacy_url",
          "platforms",
          "formats",
          "permissions",
          "features",
          "screenshots",
          "preview",
          "featured",
          "visibility",
          "revision",
          "created_at",
          "updated_at",
          "trust_dirty",
          "trust_public",
          "application_id",
          "icon_media_id",
          "icon_url",
          "initial_approved",
          "listing_draft",
          "private_access",
          "families",
          "offers",
          "releases",
          "channels"
        ],
        "type": "object"
      },
      "PublisherProductRecord": {
        "properties": {
          "accent": {
            "type": "string"
          },
          "application_id": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "featured": {
            "type": "boolean"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "homepage_url": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_media_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preview": {
            "type": "boolean"
          },
          "privacy_url": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "screenshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Screenshot"
            }
          },
          "slug": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "trust_dirty": {
            "type": "boolean"
          },
          "trust_public": {
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "organization_id",
          "slug",
          "name",
          "tagline",
          "description",
          "category",
          "icon",
          "accent",
          "license",
          "source_url",
          "homepage_url",
          "support_url",
          "privacy_url",
          "platforms",
          "formats",
          "permissions",
          "features",
          "screenshots",
          "preview",
          "featured",
          "visibility",
          "revision",
          "created_at",
          "updated_at",
          "trust_dirty",
          "trust_public",
          "application_id",
          "icon_media_id",
          "icon_url"
        ],
        "type": "object"
      },
      "PublisherPurchase": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "format": "uuid"
          },
          "buyer_id": {
            "type": "string",
            "format": "uuid"
          },
          "buyer_kind": {
            "type": "string",
            "enum": [
              "user",
              "organization"
            ]
          },
          "offer_id": {
            "type": "string",
            "format": "uuid"
          },
          "offer_name": {
            "type": "string"
          },
          "policy": {
            "type": "string",
            "enum": [
              "release_family",
              "distribution_subscription"
            ]
          },
          "family_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "quantity": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "gift": {
            "type": "boolean"
          },
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Integer minor currency units. No floating-point money."
          },
          "currency": {
            "type": "string"
          },
          "payment_mode": {
            "type": "string",
            "enum": [
              "disabled",
              "fixture",
              "stripe_test"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "paid",
              "partially_refunded",
              "refunded",
              "disputed"
            ]
          },
          "refunded_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Integer minor currency units. No floating-point money."
          },
          "paid_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "checkout_client": {
            "type": "string",
            "enum": [
              "web",
              "native",
              "embed"
            ]
          },
          "embed_origin": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "access": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PurchaseAccess"
              },
              {
                "type": "null"
              }
            ]
          },
          "subscription": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string"
                  },
                  "paid_through": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "cancel_at_period_end": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "state",
                  "paid_through",
                  "cancel_at_period_end"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "order_id",
          "buyer_id",
          "buyer_kind",
          "offer_id",
          "offer_name",
          "policy",
          "family_id",
          "quantity",
          "gift",
          "amount_minor",
          "currency",
          "payment_mode",
          "state",
          "refunded_minor",
          "paid_at",
          "created_at",
          "updated_at",
          "checkout_client",
          "embed_origin",
          "access",
          "subscription"
        ],
        "description": "One paid purchase of the publisher's app. buyer_id is the buyer's ID for this publisher: random, stable, different for every publisher, and never the Praxical account ID. buyer_kind organization means an organization bought seats. Email, names, payment provider IDs and billing details are never included. access is the purchase's entitlement (for a gift, the recipient's); updated_at orders the sync feed."
      },
      "PublisherRelease": {
        "properties": {
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "approved_digest": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "approved_snapshot": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReviewSnapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "channel": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "control_revision": {
            "format": "int64",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "family_id": {
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "manifest": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReleaseManifest"
              },
              {
                "type": "null"
              }
            ]
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publication_sequence": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "published_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "release_notes": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "rollout_percent": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "withdrawal_reason": {
            "type": "string"
          },
          "authorization_policy": {
            "type": "string",
            "enum": [
              "publisher-validated-v1",
              "initial-review"
            ]
          },
          "publisher_assertion": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkspaceAssertion"
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher_id": {
            "type": "string",
            "format": "uuid"
          },
          "uploads": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PendingUpload"
            }
          },
          "artifacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Artifact"
            }
          },
          "validation_runs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationRun"
            }
          },
          "submissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReviewSubmission"
            }
          },
          "publication": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicationRun"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "version",
          "channel",
          "state",
          "release_notes",
          "compatibility",
          "permissions",
          "revision",
          "publication_sequence",
          "published_at",
          "withdrawal_reason",
          "created_at",
          "updated_at",
          "access_class",
          "approved_snapshot",
          "approved_digest",
          "manifest",
          "rollout_percent",
          "control_revision",
          "authorization_policy",
          "publisher_assertion",
          "publisher_id",
          "uploads",
          "artifacts",
          "validation_runs",
          "submissions",
          "publication"
        ],
        "type": "object"
      },
      "PublisherReleaseSummary": {
        "properties": {
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "approved_digest": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "channel": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "control_revision": {
            "format": "int64",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "family_id": {
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "publication_sequence": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "published_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "release_notes": {
            "type": "string"
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "rollout_percent": {
            "format": "int64",
            "type": "integer"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "withdrawal_reason": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "family_id",
          "version",
          "channel",
          "state",
          "release_notes",
          "compatibility",
          "permissions",
          "revision",
          "publication_sequence",
          "published_at",
          "withdrawal_reason",
          "created_at",
          "updated_at",
          "access_class",
          "approved_digest",
          "rollout_percent",
          "control_revision"
        ],
        "type": "object"
      },
      "PublisherWebhook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "release.validation_passed",
                "release.validation_failed",
                "release.published",
                "release.withdraw",
                "release.scheduled",
                "release.schedule_blocked",
                "listing.publish",
                "payment.confirmed",
                "purchase.access_changed",
                "refund.approved",
                "refund.declined",
                "gift.redeemed",
                "license_code.redeemed",
                "license_batch.created",
                "license_batch.revoked"
              ]
            }
          },
          "enabled": {
            "type": "boolean"
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "secret_version": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "previous_valid_until": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "paused_reason": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "product_id",
          "name",
          "url",
          "events",
          "enabled",
          "revision",
          "secret_version",
          "previous_valid_until",
          "paused_reason",
          "created_at",
          "updated_at"
        ]
      },
      "PurchaseAccess": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean"
          },
          "starts_at": {
            "type": "string",
            "format": "date-time"
          },
          "ends_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revocation_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "seats": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          }
        },
        "required": [
          "active",
          "starts_at",
          "ends_at",
          "revoked_at",
          "revocation_reason",
          "seats"
        ]
      },
      "Recommendation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "author_name": {
            "type": "string"
          },
          "recommended": {
            "type": "boolean"
          },
          "body": {
            "type": "string",
            "maxLength": 4000
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "product_id",
          "author_name",
          "recommended",
          "body",
          "revision",
          "created_at",
          "updated_at"
        ]
      },
      "RecommendationPage": {
        "type": "object",
        "properties": {
          "summary": {
            "$ref": "#/components/schemas/RecommendationSummary"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Recommendation"
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "limit": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        },
        "required": [
          "summary",
          "items",
          "has_more",
          "limit",
          "offset"
        ]
      },
      "RecommendationSummary": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "recommended": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "not_recommended": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "percent_recommended": {
            "anyOf": [
              {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 100
              },
              {
                "type": "null"
              }
            ]
          },
          "recent_total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "recent_recommended": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        },
        "required": [
          "total",
          "recommended",
          "not_recommended",
          "percent_recommended",
          "recent_total",
          "recent_recommended"
        ]
      },
      "RefundRequestView": {
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "decided_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "decided_automatically": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "review": {
            "type": "string",
            "enum": [
              "automatic",
              "operator"
            ]
          },
          "review_reason": {
            "type": "string",
            "enum": [
              "",
              "outside_window",
              "not_personal",
              "partially_refunded",
              "repeat_product",
              "account_limit",
              "unconfirmed_download",
              "device_removed",
              "uninstall_declined",
              "refund_failed"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "requested",
              "approved",
              "declined",
              "completed"
            ]
          },
          "window_ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "uninstall_checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RefundUninstallCheck"
            }
          }
        },
        "required": [
          "id",
          "order_id",
          "actor_id",
          "reason",
          "state",
          "created_at",
          "review",
          "review_reason",
          "window_ends_at",
          "decided_automatically",
          "decided_at",
          "uninstall_checks"
        ],
        "type": "object",
        "description": "Refund policy (docs/policies/REFUNDS.md): available for 14 days after payment (window_ends_at). review automatic means the request is approved without an operator once every computer that downloaded the purchase confirms the app is uninstalled; decided_automatically records that it was. review operator means an operator decides, and review_reason says why: outside_window, not_personal (gifts and organization purchases), partially_refunded, repeat_product (one automatic refund per app), account_limit (three automatic refunds in 12 months), unconfirmed_download (a download not tied to a registered computer), device_removed (a computer that had to confirm was removed), uninstall_declined, or refund_failed (the payment provider failed or canceled the approved refund; approving again sends a new one). The limits and downloads are counted again at approval. Requests made before 28 September 2026 are operator with an empty reason."
      },
      "RefundUninstallCheck": {
        "type": "object",
        "properties": {
          "device_id": {
            "type": "string",
            "format": "uuid"
          },
          "device_name": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "pending",
              "confirmed",
              "declined",
              "closed"
            ]
          },
          "result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "uninstalled",
                  "not_installed",
                  "remote_uninstall"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "decided_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "remote_uninstall_available": {
            "type": "boolean"
          }
        },
        "required": [
          "device_id",
          "device_name",
          "state",
          "result",
          "decided_at",
          "remote_uninstall_available"
        ],
        "description": "One computer that downloaded the purchase. pending until the Praxical app on it answers; closed when the request no longer waits on it. remote_uninstall_available: the computer has remote installs on and can run an uninstall queued from the website, which confirms when it succeeds."
      },
      "ReleaseComparison": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "version": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "family_id": {
            "type": "string",
            "format": "uuid"
          },
          "release_notes": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "artifacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "architecture": {
                  "type": "string",
                  "enum": [
                    "x86_64",
                    "aarch64"
                  ]
                },
                "format": {
                  "type": "string",
                  "enum": [
                    "appdir",
                    "appimage",
                    "flatpak"
                  ]
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "size_bytes": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              },
              "required": [
                "architecture",
                "format",
                "sha256",
                "size_bytes"
              ]
            }
          }
        },
        "required": [
          "id",
          "version",
          "channel",
          "access_class",
          "family_id",
          "release_notes",
          "compatibility",
          "permissions",
          "artifacts"
        ]
      },
      "ReleaseControl": {
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "withdraw",
              "rollout",
              "security",
              "compatibility"
            ]
          },
          "expected_revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "reason": {
            "type": "string",
            "minLength": 8,
            "maxLength": 4000,
            "description": "Trimmed audit reason; lengths are UTF-8 byte limits in the server."
          },
          "rollout_percent": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 100,
            "default": 0
          },
          "severity": {
            "type": "string",
            "enum": [
              "notice",
              "warning",
              "critical"
            ]
          }
        },
        "required": [
          "action",
          "reason",
          "expected_revision"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "ReleaseFamily": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "name",
          "created_at"
        ],
        "type": "object"
      },
      "ReleaseInput": {
        "properties": {
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "channel": {
            "type": "string"
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "family_id": {
            "format": "uuid",
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PermissionInput"
            },
            "maxItems": 30
          },
          "release_notes": {
            "type": "string",
            "maxLength": 20000
          },
          "version": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "family_id",
          "version",
          "channel",
          "compatibility",
          "permissions",
          "access_class"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "ReleaseManifest": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "publisher_id": {
            "type": "string",
            "format": "uuid"
          },
          "release_id": {
            "type": "string",
            "format": "uuid"
          },
          "family_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "release_notes": {
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "privacy_url": {
            "type": "string"
          },
          "installation": {
            "type": "object",
            "properties": {
              "scopes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "const": "user"
                },
                "minItems": 1,
                "maxItems": 1
              },
              "profile": {
                "type": "string",
                "const": "appdir-tar-gzip-v1"
              },
              "entry_point": {
                "type": "string",
                "const": "AppDir/AppRun"
              },
              "data_policy": {
                "type": "string",
                "const": "outside-version-directory"
              }
            },
            "required": [
              "scopes",
              "profile",
              "entry_point",
              "data_policy"
            ]
          },
          "update_policy": {
            "type": "object",
            "properties": {
              "minimum_client_capability": {
                "type": "string",
                "const": "appdir-v1"
              },
              "rollback": {
                "type": "string",
                "const": "explicit-user-request"
              },
              "data_migration": {
                "type": "string",
                "const": "publisher-declared; preserve user data"
              }
            },
            "required": [
              "minimum_client_capability",
              "rollback",
              "data_migration"
            ]
          },
          "review": {
            "type": "object",
            "properties": {
              "policy": {
                "type": "string",
                "const": "static-appdir-v1"
              },
              "automated_execution": {
                "type": "boolean",
                "const": false
              },
              "malware_clearance": {
                "type": "boolean",
                "const": false
              },
              "status": {
                "type": "string",
                "const": "approved"
              },
              "submission_sha256": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              }
            },
            "required": [
              "policy",
              "automated_execution",
              "malware_clearance",
              "status",
              "submission_sha256"
            ]
          },
          "publisher_assertion": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublisherAssertion"
              },
              {
                "type": "null"
              }
            ]
          },
          "artifacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ManifestArtifact"
            },
            "minItems": 1
          },
          "application_id": {
            "type": "string",
            "description": "Public reverse-DNS app identifier bound by the approved snapshot and signed target. Added to new snapshots; historical immutable manifests can omit it. Signed product UUID remains authoritative."
          },
          "publication_sequence": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          }
        },
        "required": [
          "schema_version",
          "product_id",
          "publisher_id",
          "release_id",
          "family_id",
          "name",
          "version",
          "channel",
          "access_class",
          "revision",
          "compatibility",
          "permissions",
          "release_notes",
          "license",
          "source_url",
          "support_url",
          "privacy_url",
          "installation",
          "update_policy",
          "review",
          "publisher_assertion",
          "artifacts",
          "publication_sequence"
        ],
        "description": "Verify as a target of current TUF metadata. New snapshots bind application_id and artifact inspection resource counts; historical immutable snapshots may omit those additions. Never infer missing counts from compressed size. Enforce local hard caps and observed extraction counts regardless; measurements do not authorize package execution or data migration."
      },
      "ReleaseOperation": {
        "oneOf": [
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "finished_at": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "release_id": {
                "format": "uuid",
                "type": "string"
              },
              "report": {},
              "revision": {
                "format": "int64",
                "type": "integer"
              },
              "started_at": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "state": {
                "type": "string"
              },
              "kind": {
                "type": "string",
                "const": "validation"
              }
            },
            "required": [
              "id",
              "release_id",
              "revision",
              "state",
              "report",
              "started_at",
              "finished_at",
              "created_at",
              "kind"
            ],
            "type": "object"
          },
          {
            "properties": {
              "approved_digest": {
                "type": "string"
              },
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "error": {
                "type": "string"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "release_id": {
                "format": "uuid",
                "type": "string"
              },
              "sequence": {
                "format": "int64",
                "type": "integer"
              },
              "state": {
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "kind": {
                "type": "string",
                "const": "publication"
              }
            },
            "required": [
              "id",
              "release_id",
              "sequence",
              "approved_digest",
              "state",
              "error",
              "created_at",
              "updated_at",
              "kind"
            ],
            "type": "object"
          }
        ]
      },
      "ReleasePreflight": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string"
          },
          "release_revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "ready_to_publish": {
            "type": "boolean"
          },
          "blockers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                }
              },
              "required": [
                "code",
                "message"
              ]
            }
          },
          "current": {
            "$ref": "#/components/schemas/ReleaseComparison"
          },
          "previous": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReleaseComparison"
              },
              {
                "type": "null"
              }
            ]
          },
          "changed_fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "version",
                "channel",
                "access_class",
                "family_id",
                "release_notes",
                "compatibility",
                "permissions",
                "artifacts"
              ]
            }
          },
          "schedule": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicationSchedule"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "state",
          "release_revision",
          "ready_to_publish",
          "blockers",
          "current",
          "previous",
          "changed_fields",
          "schedule"
        ]
      },
      "ReviewSnapshot": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "integer",
            "const": 1
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "publisher_id": {
            "type": "string",
            "format": "uuid"
          },
          "release_id": {
            "type": "string",
            "format": "uuid"
          },
          "family_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "access_class": {
            "type": "string",
            "enum": [
              "community",
              "official"
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            }
          },
          "release_notes": {
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "support_url": {
            "type": "string"
          },
          "privacy_url": {
            "type": "string"
          },
          "installation": {
            "type": "object",
            "properties": {
              "scopes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "const": "user"
                },
                "minItems": 1,
                "maxItems": 1
              },
              "profile": {
                "type": "string",
                "const": "appdir-tar-gzip-v1"
              },
              "entry_point": {
                "type": "string",
                "const": "AppDir/AppRun"
              },
              "data_policy": {
                "type": "string",
                "const": "outside-version-directory"
              }
            },
            "required": [
              "scopes",
              "profile",
              "entry_point",
              "data_policy"
            ]
          },
          "update_policy": {
            "type": "object",
            "properties": {
              "minimum_client_capability": {
                "type": "string",
                "const": "appdir-v1"
              },
              "rollback": {
                "type": "string",
                "const": "explicit-user-request"
              },
              "data_migration": {
                "type": "string",
                "const": "publisher-declared; preserve user data"
              }
            },
            "required": [
              "minimum_client_capability",
              "rollback",
              "data_migration"
            ]
          },
          "review": {
            "type": "object",
            "properties": {
              "policy": {
                "type": "string",
                "const": "static-appdir-v1"
              },
              "automated_execution": {
                "type": "boolean",
                "const": false
              },
              "malware_clearance": {
                "type": "boolean",
                "const": false
              }
            },
            "required": [
              "policy",
              "automated_execution",
              "malware_clearance"
            ]
          },
          "publisher_assertion": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublisherAssertion"
              },
              {
                "type": "null"
              }
            ]
          },
          "artifacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ManifestArtifact"
            },
            "minItems": 1
          },
          "application_id": {
            "type": "string",
            "description": "Public reverse-DNS app identifier bound by the approved snapshot and signed target. Added to new snapshots; historical immutable manifests can omit it. Signed product UUID remains authoritative."
          }
        },
        "required": [
          "schema_version",
          "product_id",
          "publisher_id",
          "release_id",
          "family_id",
          "name",
          "version",
          "channel",
          "access_class",
          "revision",
          "compatibility",
          "permissions",
          "release_notes",
          "license",
          "source_url",
          "support_url",
          "privacy_url",
          "installation",
          "update_policy",
          "review",
          "publisher_assertion",
          "artifacts"
        ],
        "description": "Verify as a target of current TUF metadata. New snapshots bind application_id and artifact inspection resource counts; historical immutable snapshots may omit those additions. Never infer missing counts from compressed size. Enforce local hard caps and observed extraction counts regardless; measurements do not authorize package execution or data migration."
      },
      "ReviewSubmission": {
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "sha256": {
            "type": "string"
          },
          "snapshot": {},
          "state": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "release_id",
          "actor_id",
          "kind",
          "revision",
          "snapshot",
          "sha256",
          "state",
          "created_at"
        ],
        "type": "object"
      },
      "Screenshot": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "alt": {
            "type": "string"
          },
          "media_id": {
            "type": "string",
            "format": "uuid"
          },
          "width": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "height": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        },
        "required": [
          "url",
          "alt"
        ]
      },
      "StoreConfig": {
        "type": "object",
        "properties": {
          "development_accounts": {
            "type": "boolean"
          },
          "payments": {
            "type": "string",
            "enum": [
              "disabled",
              "fixture",
              "stripe_test"
            ]
          },
          "identity_provider": {
            "type": "string",
            "enum": [
              "development",
              "sapphire"
            ]
          },
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "license_codes": {
            "type": "boolean"
          },
          "developer_url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "development_accounts",
          "payments",
          "identity_provider",
          "api_version",
          "license_codes",
          "developer_url"
        ]
      },
      "StoreStatistics": {
        "properties": {
          "architectures": {
            "items": {
              "properties": {
                "count": {
                  "format": "int64",
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "count"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "as_of": {
            "format": "date-time",
            "type": "string"
          },
          "categories": {
            "items": {
              "properties": {
                "count": {
                  "format": "int64",
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "count"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "collection_started_at": {
            "format": "date-time",
            "type": "string"
          },
          "formats": {
            "items": {
              "properties": {
                "count": {
                  "format": "int64",
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "count"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "rankings": {
            "items": {
              "properties": {
                "accent": {
                  "type": "string"
                },
                "application_id": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "downloads": {
                  "format": "int64",
                  "type": "integer"
                },
                "icon": {
                  "type": "string"
                },
                "icon_url": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "preview": {
                  "type": "boolean"
                },
                "previous_week": {
                  "format": "int64",
                  "type": "integer"
                },
                "product_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "tagline": {
                  "type": "string"
                },
                "week": {
                  "format": "int64",
                  "type": "integer"
                }
              },
              "required": [
                "product_id",
                "application_id",
                "slug",
                "name",
                "tagline",
                "category",
                "icon",
                "icon_url",
                "accent",
                "preview",
                "downloads",
                "week",
                "previous_week"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "timeline": {
            "items": {
              "properties": {
                "bytes": {
                  "format": "int64",
                  "type": "integer"
                },
                "day": {
                  "type": "string"
                },
                "downloads": {
                  "format": "int64",
                  "type": "integer"
                }
              },
              "required": [
                "day",
                "downloads",
                "bytes"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "totals": {
            "properties": {
              "apps": {
                "format": "int64",
                "type": "integer"
              },
              "bytes": {
                "format": "int64",
                "type": "integer"
              },
              "downloads": {
                "format": "int64",
                "type": "integer"
              }
            },
            "required": [
              "apps",
              "downloads",
              "bytes"
            ],
            "type": "object"
          },
          "trending": {
            "items": {
              "properties": {
                "accent": {
                  "type": "string"
                },
                "application_id": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "downloads": {
                  "format": "int64",
                  "type": "integer"
                },
                "icon": {
                  "type": "string"
                },
                "icon_url": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "preview": {
                  "type": "boolean"
                },
                "previous_week": {
                  "format": "int64",
                  "type": "integer"
                },
                "product_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "tagline": {
                  "type": "string"
                },
                "week": {
                  "format": "int64",
                  "type": "integer"
                }
              },
              "required": [
                "product_id",
                "application_id",
                "slug",
                "name",
                "tagline",
                "category",
                "icon",
                "icon_url",
                "accent",
                "preview",
                "downloads",
                "week",
                "previous_week"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "as_of",
          "collection_started_at",
          "totals",
          "timeline",
          "rankings",
          "trending",
          "categories",
          "architectures",
          "formats"
        ],
        "type": "object"
      },
      "Subscription": {
        "properties": {
          "billing_account_id": {
            "format": "uuid",
            "type": "string"
          },
          "cancel_at_period_end": {
            "type": "boolean"
          },
          "cancellation_requested_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "current_period_start": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "grace_until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_id": {
            "format": "uuid",
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "paid_through": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "order_id",
          "billing_account_id",
          "product_id",
          "offer_id",
          "state",
          "current_period_start",
          "paid_through",
          "cancel_at_period_end",
          "cancellation_requested_at",
          "updated_at",
          "created_at",
          "grace_until"
        ],
        "type": "object"
      },
      "SubscriptionView": {
        "properties": {
          "billing_account_id": {
            "format": "uuid",
            "type": "string"
          },
          "cancel_at_period_end": {
            "type": "boolean"
          },
          "cancellation_requested_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "current_period_start": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "grace_until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "offer_id": {
            "format": "uuid",
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "paid_through": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "product_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "icon_url": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Integer minor currency units. No floating-point money."
          },
          "currency": {
            "type": "string"
          },
          "billing_interval": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "organization_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "payment_mode": {
            "type": "string",
            "enum": [
              "disabled",
              "fixture",
              "stripe_test"
            ]
          },
          "access_ends_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "order_id",
          "billing_account_id",
          "product_id",
          "offer_id",
          "state",
          "current_period_start",
          "paid_through",
          "cancel_at_period_end",
          "cancellation_requested_at",
          "updated_at",
          "created_at",
          "grace_until",
          "product_name",
          "product_slug",
          "icon",
          "icon_url",
          "accent",
          "amount_minor",
          "currency",
          "billing_interval",
          "organization_name",
          "payment_mode",
          "access_ends_at",
          "revoked_at"
        ],
        "type": "object"
      },
      "TUFEnvelope": {
        "type": "object",
        "properties": {
          "signed": {
            "type": "object",
            "description": "TUF root/timestamp/snapshot/targets metadata. Use the maintained TUF library to validate role schemas, thresholds, version and expiry.",
            "additionalProperties": true
          },
          "signatures": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "keyid": {
                  "type": "string"
                },
                "sig": {
                  "type": "string"
                }
              },
              "required": [
                "keyid",
                "sig"
              ]
            }
          }
        },
        "required": [
          "signed",
          "signatures"
        ]
      },
      "UpdateInput": {
        "properties": {
          "access_class": {
            "type": "string",
            "default": "community"
          },
          "architecture": {
            "type": "string"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "channel": {
            "type": "string",
            "description": "If omitted or empty, use the valid account preference, otherwise stable. An explicit channel overrides the account preference."
          },
          "cohort": {
            "type": "string",
            "description": "Stable per-install random value, scoped by product for rollout bucketing. Do not send a hardware identifier."
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "installed_release_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "architecture",
          "formats",
          "capabilities"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "UpdateResult": {
        "properties": {
          "compatibility": {
            "$ref": "#/components/schemas/Compatibility"
          },
          "manifest_url": {
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "type": "string",
            "enum": [
              "update_available",
              "up_to_date",
              "unsupported_architecture",
              "client_capability_required",
              "metadata_refresh_pending",
              "unknown_installed_release",
              "installed_release_withdrawn",
              "no_compatible_release",
              "rollout_cohort_required",
              "staged_rollout",
              "not_found",
              "withdrawn",
              "not_published",
              "sign_in_required",
              "account_inactive",
              "official_access_required",
              "channel_access_required"
            ]
          },
          "release_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "reason"
        ],
        "type": "object",
        "description": "A suggestion, not an installation authorization or signature. Verify current TUF channels/advisories, the target manifest and artifact; evaluate the host baseline; obtain a fresh grant for the exact artifact. The resolver never chooses an automatic downgrade."
      },
      "UploadInput": {
        "properties": {
          "architecture": {
            "type": "string",
            "enum": [
              "x86_64",
              "aarch64"
            ]
          },
          "filename": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
          },
          "format": {
            "type": "string",
            "const": "appdir"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "size_bytes": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "maximum": 1073741824
          }
        },
        "required": [
          "release_id",
          "format",
          "architecture",
          "filename",
          "sha256",
          "size_bytes"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "UploadResult": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "headers": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "method": {
            "type": "string"
          },
          "multipart": {
            "type": "boolean"
          },
          "part_size": {
            "format": "int64",
            "type": "integer"
          },
          "upload_url": {
            "type": "string"
          }
        },
        "required": [
          "multipart",
          "part_size",
          "id",
          "upload_url",
          "method",
          "headers",
          "expires_at"
        ],
        "type": "object",
        "description": "For a single upload, PUT exact bytes with the returned headers to upload_url. Multipart sessions have an empty upload_url; request/confirm parts then complete. Part confirmation can return empty URL, null headers, multipart=false and part_size=0; those transport fields are unused on confirmation. Never send session or API bearer credentials to storage."
      },
      "UploadStatus": {
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "architecture": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "expected_sha256": {
            "type": "string"
          },
          "expected_size": {
            "format": "int64",
            "type": "integer"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "multipart": {
            "type": "boolean"
          },
          "part_size": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "parts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "part_number": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 1,
                  "maximum": 128
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "etag": {
                  "type": "string"
                }
              },
              "required": [
                "part_number",
                "sha256",
                "etag"
              ]
            }
          }
        },
        "required": [
          "id",
          "release_id",
          "actor_id",
          "format",
          "architecture",
          "filename",
          "expected_sha256",
          "expected_size",
          "state",
          "expires_at",
          "created_at",
          "multipart",
          "part_size",
          "parts"
        ],
        "type": "object"
      },
      "ValidationRun": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "release_id": {
            "format": "uuid",
            "type": "string"
          },
          "report": {
            "type": "object",
            "description": "Versioned inspection summary; individual artifact reports contain profile, file/byte counts, architecture, checks and findings. Empty before completion.",
            "additionalProperties": true
          },
          "revision": {
            "format": "int64",
            "type": "integer"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "release_id",
          "revision",
          "state",
          "report",
          "started_at",
          "finished_at",
          "created_at"
        ],
        "type": "object"
      },
      "WebhookAttempt": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "delivery_id": {
            "type": "string",
            "format": "uuid"
          },
          "attempt": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "state": {
            "type": "string",
            "enum": [
              "delivered",
              "failed"
            ]
          },
          "http_status": {
            "anyOf": [
              {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ]
          },
          "error": {
            "type": "string"
          },
          "duration_ms": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "secret_version": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "delivery_id",
          "attempt",
          "state",
          "http_status",
          "error",
          "duration_ms",
          "secret_version",
          "created_at"
        ]
      },
      "WebhookDelivery": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "event_id": {
            "type": "string",
            "format": "uuid"
          },
          "webhook_id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "pending",
              "sending",
              "delivered",
              "failed",
              "canceled"
            ]
          },
          "attempts": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "next_attempt_at": {
            "type": "string",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "delivered_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_error": {
            "type": "string"
          },
          "http_status": {
            "anyOf": [
              {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "event_id",
          "webhook_id",
          "type",
          "state",
          "attempts",
          "next_attempt_at",
          "expires_at",
          "delivered_at",
          "last_error",
          "http_status",
          "revision",
          "created_at"
        ]
      },
      "WebhookEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "product_id": {
            "type": "string",
            "format": "uuid"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "type",
          "timestamp",
          "api_version",
          "product_id",
          "data"
        ]
      },
      "WebhookSecret": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "secret": {
            "type": "string",
            "pattern": "^whsec_",
            "description": "Shown only on create/rotation. Store in receiver secret storage; never log."
          },
          "revision": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "secret_version": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "previous_valid_until": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "secret",
          "revision",
          "secret_version",
          "previous_valid_until"
        ]
      },
      "WorkspaceAssertion": {
        "type": "object",
        "properties": {
          "key_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "payload": {
            "type": "string"
          },
          "signature": {
            "type": "string"
          }
        },
        "required": [
          "key_id",
          "name",
          "fingerprint",
          "revoked_at",
          "payload",
          "signature"
        ]
      }
    }
  }
}
