{
  "components": {
    "schemas": {
      "Body_upload_banner_api_partners_v1_customers__customer_ref__assets_post": {
        "properties": {
          "file": {
            "contentMediaType": "application/octet-stream",
            "description": "PNG, JPEG or WebP profile photo or banner, up to 8 MB.",
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_banner_api_partners_v1_customers__customer_ref__assets_post",
        "type": "object"
      },
      "CartItemRequest": {
        "additionalProperties": false,
        "examples": [
          {
            "profile_id": "11111111-1111-4111-8111-111111111111"
          }
        ],
        "properties": {
          "profile_id": {
            "description": "Inventory profile UUID from the catalogue; not a purchased/cart line ID.",
            "format": "uuid",
            "title": "Profile Id",
            "type": "string"
          }
        },
        "required": [
          "profile_id"
        ],
        "title": "CartItemRequest",
        "type": "object"
      },
      "CatalogListingRead": {
        "properties": {
          "account_age_band": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Account Age Band"
          },
          "account_age_months": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Account Age Months"
          },
          "age_approximate": {
            "title": "Age Approximate",
            "type": "boolean"
          },
          "age_max": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Max"
          },
          "age_min": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Min"
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "City"
          },
          "connection_band": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Connection Band"
          },
          "connections": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Connections"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "currency": {
            "const": "USD",
            "default": "USD",
            "title": "Currency",
            "type": "string"
          },
          "delivery_state": {
            "default": "ready",
            "enum": [
              "warming",
              "ready",
              "confirming"
            ],
            "title": "Delivery State",
            "type": "string"
          },
          "facts_as_of": {
            "format": "date",
            "title": "Facts As Of",
            "type": "string"
          },
          "first_name_prefix": {
            "maxLength": 2,
            "title": "First Name Prefix",
            "type": "string"
          },
          "full_name": {
            "title": "Full Name",
            "type": "string"
          },
          "gender": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gender"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "last_name_prefix": {
            "maxLength": 2,
            "title": "Last Name Prefix",
            "type": "string"
          },
          "linkedin_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Linkedin Url"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Full location text supplied for this profile.",
            "title": "Location"
          },
          "monthly_price_cents": {
            "title": "Monthly Price Cents",
            "type": "integer"
          },
          "person_age": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Person Age"
          },
          "profile_image_url": {
            "anyOf": [
              {
                "format": "uri",
                "maxLength": 2083,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Image Url"
          },
          "region": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Region"
          },
          "reservation_state": {
            "default": "available",
            "enum": [
              "available",
              "reserved",
              "checking"
            ],
            "title": "Reservation State",
            "type": "string"
          },
          "reserved_by_you": {
            "default": false,
            "title": "Reserved By You",
            "type": "boolean"
          },
          "reserved_until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reserved Until"
          },
          "verification": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification"
          },
          "verification_confirmed": {
            "description": "Display a verification claim as confirmed only when this is true.",
            "title": "Verification Confirmed",
            "type": "boolean"
          },
          "verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True for individual verification or a supplier-wide guarantee, false for explicit absence, null when unknown.",
            "title": "Verified"
          }
        },
        "required": [
          "id",
          "full_name",
          "first_name_prefix",
          "last_name_prefix",
          "gender",
          "connections",
          "connection_band",
          "person_age",
          "age_min",
          "age_max",
          "age_approximate",
          "facts_as_of",
          "country",
          "region",
          "city",
          "verification",
          "verification_confirmed",
          "account_age_months",
          "account_age_band",
          "monthly_price_cents",
          "linkedin_url"
        ],
        "title": "CatalogListingRead",
        "type": "object"
      },
      "CatalogPageRead": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/CatalogListingRead"
            },
            "title": "Items",
            "type": "array"
          },
          "page": {
            "title": "Page",
            "type": "integer"
          },
          "page_size": {
            "title": "Page Size",
            "type": "integer"
          },
          "server_time": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Server timestamp for expiry countdown calibration; may be null.",
            "title": "Server Time"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "page",
          "page_size"
        ],
        "title": "CatalogPageRead",
        "type": "object"
      },
      "CatalogProfileRead": {
        "properties": {
          "account_age_band": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Account Age Band"
          },
          "account_age_months": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Account Age Months"
          },
          "age_approximate": {
            "title": "Age Approximate",
            "type": "boolean"
          },
          "age_max": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Max"
          },
          "age_min": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Min"
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "City"
          },
          "connection_band": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Connection Band"
          },
          "connections": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Connections"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "currency": {
            "const": "USD",
            "default": "USD",
            "title": "Currency",
            "type": "string"
          },
          "delivery_state": {
            "default": "ready",
            "enum": [
              "warming",
              "ready",
              "confirming"
            ],
            "title": "Delivery State",
            "type": "string"
          },
          "facts_as_of": {
            "format": "date",
            "title": "Facts As Of",
            "type": "string"
          },
          "first_name_prefix": {
            "maxLength": 2,
            "title": "First Name Prefix",
            "type": "string"
          },
          "full_name": {
            "title": "Full Name",
            "type": "string"
          },
          "gender": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gender"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "last_name_prefix": {
            "maxLength": 2,
            "title": "Last Name Prefix",
            "type": "string"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Full location text supplied for this profile.",
            "title": "Location"
          },
          "monthly_price_cents": {
            "title": "Monthly Price Cents",
            "type": "integer"
          },
          "person_age": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Person Age"
          },
          "profile_image_url": {
            "anyOf": [
              {
                "format": "uri",
                "maxLength": 2083,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Image Url"
          },
          "region": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Region"
          },
          "verification": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification"
          },
          "verification_confirmed": {
            "description": "Display a verification claim as confirmed only when this is true.",
            "title": "Verification Confirmed",
            "type": "boolean"
          },
          "verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True for individual verification or a supplier-wide guarantee, false for explicit absence, null when unknown.",
            "title": "Verified"
          }
        },
        "required": [
          "id",
          "full_name",
          "first_name_prefix",
          "last_name_prefix",
          "gender",
          "connections",
          "connection_band",
          "person_age",
          "age_min",
          "age_max",
          "age_approximate",
          "facts_as_of",
          "country",
          "region",
          "city",
          "verification",
          "verification_confirmed",
          "account_age_months",
          "account_age_band",
          "monthly_price_cents"
        ],
        "title": "CatalogProfileRead",
        "type": "object"
      },
      "CatalogSupplierReplacement": {
        "additionalProperties": false,
        "properties": {
          "inventory_id": {
            "format": "uuid",
            "title": "Inventory Id",
            "type": "string"
          }
        },
        "required": [
          "inventory_id"
        ],
        "title": "CatalogSupplierReplacement",
        "type": "object"
      },
      "ConnectionReport": {
        "additionalProperties": false,
        "properties": {
          "note": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Note"
          },
          "sequencer": {
            "maxLength": 80,
            "minLength": 1,
            "title": "Sequencer",
            "type": "string"
          }
        },
        "required": [
          "sequencer"
        ],
        "title": "ConnectionReport",
        "type": "object"
      },
      "ConnectionStatusRead": {
        "properties": {
          "checked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Checked At"
          },
          "connection_status": {
            "enum": [
              "unknown",
              "connected",
              "disconnected"
            ],
            "title": "Connection Status",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "line_id": {
            "format": "uuid",
            "title": "Line Id",
            "type": "string"
          },
          "monitor_issue": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Monitor Issue"
          },
          "monitored": {
            "title": "Monitored",
            "type": "boolean"
          },
          "order_id": {
            "format": "uuid",
            "title": "Order Id",
            "type": "string"
          },
          "sequencer": {
            "title": "Sequencer",
            "type": "string"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "ticket_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ticket Id"
          },
          "ticket_path": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ticket Path"
          },
          "ticket_status": {
            "anyOf": [
              {
                "enum": [
                  "reported",
                  "in_progress",
                  "resolved"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ticket Status"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "line_id",
          "order_id",
          "sequencer",
          "connection_status",
          "source",
          "updated_at",
          "ticket_id",
          "ticket_status",
          "ticket_path",
          "monitored",
          "checked_at",
          "monitor_issue"
        ],
        "title": "ConnectionStatusRead",
        "type": "object"
      },
      "EducationEntry": {
        "additionalProperties": false,
        "properties": {
          "degree": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Degree"
          },
          "ended_year": {
            "anyOf": [
              {
                "maximum": 2100.0,
                "minimum": 1950.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ended Year"
          },
          "field_of_study": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Field Of Study"
          },
          "school": {
            "maxLength": 200,
            "minLength": 1,
            "title": "School",
            "type": "string"
          },
          "started_year": {
            "anyOf": [
              {
                "maximum": 2100.0,
                "minimum": 1950.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started Year"
          }
        },
        "required": [
          "school"
        ],
        "title": "EducationEntry",
        "type": "object"
      },
      "ExperienceEntry": {
        "additionalProperties": false,
        "description": "One position on the persona's history, newest first in the list.",
        "properties": {
          "company": {
            "maxLength": 200,
            "minLength": 1,
            "title": "Company",
            "type": "string"
          },
          "ended_on": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ended On"
          },
          "started_on": {
            "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
            "title": "Started On",
            "type": "string"
          },
          "summary": {
            "anyOf": [
              {
                "maxLength": 1200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "title": {
            "maxLength": 200,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "company",
          "started_on"
        ],
        "title": "ExperienceEntry",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "InitialProfileChange": {
        "additionalProperties": false,
        "properties": {
          "about": {
            "anyOf": [
              {
                "maxLength": 2600,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Permitted About text; empty string clears it, omission preserves it.",
            "title": "About"
          },
          "banner_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Private banner asset UUID uploaded for this customer binding.",
            "title": "Banner Asset Id"
          },
          "education": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/EducationEntry"
                },
                "maxItems": 6,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Education"
          },
          "experience": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ExperienceEntry"
                },
                "maxItems": 12,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Experience"
          },
          "featured": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 10,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Featured"
          },
          "headline": {
            "anyOf": [
              {
                "maxLength": 220,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Truthful permitted headline; omit if unchanged. An empty headline is invalid.",
            "title": "Headline"
          },
          "inventory_id": {
            "description": "Inventory profile UUID currently in the customer's cart.",
            "format": "uuid",
            "title": "Inventory Id",
            "type": "string"
          },
          "reposts": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 3,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts"
          }
        },
        "required": [
          "inventory_id"
        ],
        "title": "InitialProfileChange",
        "type": "object"
      },
      "PartnerAPIError": {
        "properties": {
          "detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              }
            ],
            "description": "An actionable error string, or validation detail array."
          }
        },
        "required": [
          "detail"
        ],
        "type": "object"
      },
      "PartnerAssetRead": {
        "properties": {
          "asset_id": {
            "format": "uuid",
            "title": "Asset Id",
            "type": "string"
          },
          "mime_type": {
            "enum": [
              "image/png",
              "image/jpeg",
              "image/webp"
            ],
            "title": "Mime Type",
            "type": "string"
          },
          "size_bytes": {
            "title": "Size Bytes",
            "type": "integer"
          }
        },
        "required": [
          "asset_id",
          "mime_type",
          "size_bytes"
        ],
        "title": "PartnerAssetRead",
        "type": "object"
      },
      "PartnerChangeCreate": {
        "additionalProperties": false,
        "examples": [
          {
            "headline": "Approved professional headline",
            "line_id": "22222222-2222-4222-8222-222222222222"
          }
        ],
        "properties": {
          "about": {
            "anyOf": [
              {
                "maxLength": 2600,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Permitted About text; empty string clears it, omission preserves it.",
            "title": "About"
          },
          "banner_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Private banner asset UUID uploaded for this customer binding.",
            "title": "Banner Asset Id"
          },
          "education": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/EducationEntry"
                },
                "maxItems": 6,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Education"
          },
          "experience": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ExperienceEntry"
                },
                "maxItems": 12,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Experience"
          },
          "featured": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 10,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Featured"
          },
          "headline": {
            "anyOf": [
              {
                "maxLength": 220,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Truthful permitted headline; omit if unchanged. An empty headline is invalid.",
            "title": "Headline"
          },
          "line_id": {
            "description": "Purchased/cart line UUID returned in lines[].id; not the inventory profile ID.",
            "format": "uuid",
            "title": "Line Id",
            "type": "string"
          },
          "reposts": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 3,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts"
          }
        },
        "required": [
          "line_id"
        ],
        "title": "PartnerChangeCreate",
        "type": "object"
      },
      "PartnerChangeRead": {
        "properties": {
          "allowed_change_fields": {
            "items": {
              "type": "string"
            },
            "title": "Allowed Change Fields",
            "type": "array"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "fields": {
            "items": {
              "type": "string"
            },
            "title": "Fields",
            "type": "array"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "initial": {
            "title": "Initial",
            "type": "boolean"
          },
          "line_id": {
            "description": "Purchased/cart line UUID returned in lines[].id; not the inventory profile ID.",
            "format": "uuid",
            "title": "Line Id",
            "type": "string"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "messages": {
            "description": "Customer-facing request history; preserve its order.",
            "items": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "title": "Messages",
            "type": "array"
          },
          "next_step": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Customer-facing next action when follow-up is needed.",
            "title": "Next Step"
          },
          "profile_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Name"
          },
          "requested_changes": {
            "$ref": "#/components/schemas/RequestedProfileChanges"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "source": {
            "default": "profile",
            "enum": [
              "profile",
              "company_banner",
              "company_defaults"
            ],
            "title": "Source",
            "type": "string"
          },
          "state": {
            "enum": [
              "submitted",
              "in_progress",
              "needs_information",
              "completed",
              "failed",
              "cancelled"
            ],
            "title": "State",
            "type": "string"
          }
        },
        "required": [
          "id",
          "line_id",
          "state",
          "initial",
          "revision",
          "message",
          "fields",
          "requested_changes",
          "messages",
          "next_step"
        ],
        "title": "PartnerChangeRead",
        "type": "object"
      },
      "PartnerCheckout": {
        "additionalProperties": false,
        "examples": [
          {
            "consent": true,
            "initial_changes": [],
            "permitted_activities": [
              "comment"
            ]
          }
        ],
        "properties": {
          "consent": {
            "const": true,
            "description": "Must be true only after an explicit customer decision.",
            "title": "Consent",
            "type": "boolean"
          },
          "elements": {
            "default": false,
            "description": "Leave false for Partner API checkout, which uses hosted Stripe Checkout.",
            "title": "Elements",
            "type": "boolean"
          },
          "initial_changes": {
            "description": "Optional permitted configuration, at most one entry per selected inventory ID.",
            "items": {
              "$ref": "#/components/schemas/InitialProfileChange"
            },
            "maxItems": 100,
            "title": "Initial Changes",
            "type": "array"
          },
          "permitted_activities": {
            "description": "Only the activities this customer actually authorized. At least one is required.",
            "items": {
              "enum": [
                "connect",
                "post",
                "like",
                "repost",
                "comment"
              ],
              "type": "string"
            },
            "minItems": 1,
            "title": "Permitted Activities",
            "type": "array"
          }
        },
        "required": [
          "consent",
          "permitted_activities"
        ],
        "title": "PartnerCheckout",
        "type": "object"
      },
      "PartnerCommissionInvoiceRead": {
        "properties": {
          "available_cents": {
            "description": "Net commission less holds BEFORE recorded-payment deductions. Use outstanding_cents for the remaining partner balance.",
            "title": "Available Cents",
            "type": "integer"
          },
          "collected_cents": {
            "description": "Verified Stripe-collected cash in integer USD cents.",
            "title": "Collected Cents",
            "type": "integer"
          },
          "commission_cents": {
            "description": "Net commission after confirmed adjustments, in integer USD cents.",
            "title": "Commission Cents",
            "type": "integer"
          },
          "currency": {
            "const": "usd",
            "title": "Currency",
            "type": "string"
          },
          "eligible_cents": {
            "description": "Collected subscription revenue eligible for commission after attributable tax and confirmed adjustments.",
            "title": "Eligible Cents",
            "type": "integer"
          },
          "held_cents": {
            "description": "Commission currently held during pending disputes, in integer USD cents.",
            "title": "Held Cents",
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "invoice_id": {
            "title": "Invoice Id",
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "title": "Order Id",
            "type": "string"
          },
          "rate_bps": {
            "description": "Recurring commission basis points snapshotted for this subscription; 1250 means 12.5%.",
            "title": "Rate Bps",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "invoice_id",
          "order_id",
          "currency",
          "rate_bps",
          "collected_cents",
          "eligible_cents",
          "commission_cents",
          "held_cents",
          "available_cents"
        ],
        "title": "PartnerCommissionInvoiceRead",
        "type": "object"
      },
      "PartnerCommissionRead": {
        "properties": {
          "available_cents": {
            "description": "Net commission less holds BEFORE recorded-payment deductions. Use outstanding_cents for the remaining partner balance.",
            "title": "Available Cents",
            "type": "integer"
          },
          "commission_cents": {
            "description": "Net commission after confirmed adjustments, in integer USD cents.",
            "title": "Commission Cents",
            "type": "integer"
          },
          "currency": {
            "const": "usd",
            "title": "Currency",
            "type": "string"
          },
          "held_cents": {
            "description": "Commission currently held during pending disputes, in integer USD cents.",
            "title": "Held Cents",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PartnerCommissionInvoiceRead"
            },
            "title": "Items",
            "type": "array"
          },
          "outstanding_cents": {
            "description": "Available commission minus recorded settlements. May be negative after refunds or holds; do not clamp to zero.",
            "title": "Outstanding Cents",
            "type": "integer"
          },
          "page": {
            "title": "Page",
            "type": "integer"
          },
          "page_size": {
            "title": "Page Size",
            "type": "integer"
          },
          "settled_cents": {
            "description": "Completed payments recorded by More Accounts, excluding voided receipts.",
            "title": "Settled Cents",
            "type": "integer"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "currency",
          "commission_cents",
          "held_cents",
          "available_cents",
          "settled_cents",
          "outstanding_cents",
          "total",
          "page",
          "page_size",
          "items"
        ],
        "title": "PartnerCommissionRead",
        "type": "object"
      },
      "PartnerCurrentProfile": {
        "properties": {
          "about": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "About"
          },
          "background_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Background Image Url"
          },
          "banner_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Banner Asset Id"
          },
          "education": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/EducationEntry"
                },
                "maxItems": 6,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Education"
          },
          "experience": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ExperienceEntry"
                },
                "maxItems": 12,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Experience"
          },
          "featured": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 10,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Featured"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Headline"
          },
          "photo_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Photo Asset Id"
          },
          "profile_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Profile Image Url"
          },
          "reposts": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 3,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts"
          }
        },
        "title": "PartnerCurrentProfile",
        "type": "object"
      },
      "PartnerCustomerPut": {
        "additionalProperties": false,
        "examples": [
          {
            "business_brief": "Professional consulting services for small businesses.",
            "company": "Example Company",
            "owner_email": "alex@example.com",
            "owner_name": "Alex Example",
            "website": "https://example.com"
          }
        ],
        "properties": {
          "business_brief": {
            "description": "Truthful description of the company and intended use, 10–4000 characters.",
            "maxLength": 4000,
            "minLength": 10,
            "title": "Business Brief",
            "type": "string"
          },
          "company": {
            "description": "Customer company/team name.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Company",
            "type": "string"
          },
          "owner_email": {
            "description": "Customer contact email; matching another record never grants access.",
            "format": "email",
            "title": "Owner Email",
            "type": "string"
          },
          "owner_name": {
            "description": "Named customer contact.",
            "maxLength": 120,
            "minLength": 1,
            "title": "Owner Name",
            "type": "string"
          },
          "website": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional public HTTPS website.",
            "title": "Website"
          }
        },
        "required": [
          "company",
          "owner_name",
          "owner_email",
          "business_brief"
        ],
        "title": "PartnerCustomerPut",
        "type": "object"
      },
      "PartnerCustomerRead": {
        "additionalProperties": false,
        "properties": {
          "business_brief": {
            "description": "Truthful description of the company and intended use, 10–4000 characters.",
            "maxLength": 4000,
            "minLength": 10,
            "title": "Business Brief",
            "type": "string"
          },
          "company": {
            "description": "Customer company/team name.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Company",
            "type": "string"
          },
          "customer_ref": {
            "description": "Partner-scoped customer/company reference.",
            "title": "Customer Ref",
            "type": "string"
          },
          "owner_email": {
            "description": "Customer contact email; matching another record never grants access.",
            "format": "email",
            "title": "Owner Email",
            "type": "string"
          },
          "owner_name": {
            "description": "Named customer contact.",
            "maxLength": 120,
            "minLength": 1,
            "title": "Owner Name",
            "type": "string"
          },
          "website": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional public HTTPS website.",
            "title": "Website"
          }
        },
        "required": [
          "company",
          "owner_name",
          "owner_email",
          "business_brief",
          "customer_ref"
        ],
        "title": "PartnerCustomerRead",
        "type": "object"
      },
      "PartnerEventEnvelope": {
        "description": "Verified status event. Deduplicate by signed body id; apply only newer versions per (type,data.id). The partner-wide counter is not gap-free for one resource.",
        "oneOf": [
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/PartnerPurchaseRead"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "type": {
                "const": "purchase.updated",
                "type": "string"
              },
              "version": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "type",
              "version",
              "created_at",
              "data"
            ],
            "type": "object"
          },
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/PartnerChangeRead"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "type": {
                "const": "change_request.updated",
                "type": "string"
              },
              "version": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "type",
              "version",
              "created_at",
              "data"
            ],
            "type": "object"
          },
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/PartnerCommissionInvoiceRead"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "type": {
                "const": "commission.updated",
                "type": "string"
              },
              "version": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "type",
              "version",
              "created_at",
              "data"
            ],
            "type": "object"
          },
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/PartnerSettlementRead"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "type": {
                "const": "settlement.updated",
                "type": "string"
              },
              "version": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "type",
              "version",
              "created_at",
              "data"
            ],
            "type": "object"
          },
          {
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/ConnectionStatusRead"
              },
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "type": {
                "const": "profile_connection.updated",
                "type": "string"
              },
              "version": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "id",
              "type",
              "version",
              "created_at",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "PartnerLineRead": {
        "properties": {
          "allowed_change_fields": {
            "description": "Currently authorized fields for this purchase. Submit a banner via banner_asset_id.",
            "items": {
              "type": "string"
            },
            "title": "Allowed Change Fields",
            "type": "array"
          },
          "banner_source": {
            "default": "company",
            "enum": [
              "company",
              "custom"
            ],
            "title": "Banner Source",
            "type": "string"
          },
          "branding_variables": {
            "additionalProperties": {
              "type": "string"
            },
            "title": "Branding Variables",
            "type": "object"
          },
          "company_banner_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company Banner Asset Id"
          },
          "connections": {
            "items": {
              "$ref": "#/components/schemas/ConnectionStatusRead"
            },
            "title": "Connections",
            "type": "array"
          },
          "current_profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PartnerCurrentProfile"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Recorded profile details and verified previous changes. Missing values are unknown. Retrieve uploaded images through this customer's assets endpoint."
          },
          "customer_access_eligible": {
            "default": false,
            "title": "Customer Access Eligible",
            "type": "boolean"
          },
          "customer_access_enabled": {
            "default": false,
            "description": "True only after a More Accounts Owner manually enables direct access for this exact managed profile and current purchase.",
            "title": "Customer Access Enabled",
            "type": "boolean"
          },
          "ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ends At"
          },
          "fulfillment_state": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fulfillment State"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "initial_change_fields": {
            "items": {
              "type": "string"
            },
            "title": "Initial Change Fields",
            "type": "array"
          },
          "profile": {
            "$ref": "#/components/schemas/CatalogProfileRead"
          },
          "refund_available": {
            "default": false,
            "title": "Refund Available",
            "type": "boolean"
          },
          "replacement_required": {
            "default": false,
            "title": "Replacement Required",
            "type": "boolean"
          },
          "restriction": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RestrictionStatusRead"
              },
              {
                "type": "null"
              }
            ]
          },
          "service_state": {
            "description": "Current service state, including confirming_profile, choose_replacement, refund_pending or refunded for paid supplier selections. Render future states without failing.",
            "title": "Service State",
            "type": "string"
          },
          "state": {
            "title": "State",
            "type": "string"
          },
          "text_branding": {
            "additionalProperties": {
              "$ref": "#/components/schemas/ProfileTextBranding"
            },
            "propertyNames": {
              "enum": [
                "headline",
                "about"
              ]
            },
            "title": "Text Branding",
            "type": "object"
          }
        },
        "required": [
          "id",
          "profile",
          "state",
          "ends_at",
          "service_state",
          "allowed_change_fields"
        ],
        "title": "PartnerLineRead",
        "type": "object"
      },
      "PartnerProfileChange": {
        "additionalProperties": false,
        "properties": {
          "about": {
            "anyOf": [
              {
                "maxLength": 2600,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Permitted About text; empty string clears it, omission preserves it.",
            "title": "About"
          },
          "banner_asset_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Private banner asset UUID uploaded for this customer binding.",
            "title": "Banner Asset Id"
          },
          "education": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/EducationEntry"
                },
                "maxItems": 6,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Education"
          },
          "experience": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ExperienceEntry"
                },
                "maxItems": 12,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Experience"
          },
          "featured": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 10,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Featured"
          },
          "headline": {
            "anyOf": [
              {
                "maxLength": 220,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Truthful permitted headline; omit if unchanged. An empty headline is invalid.",
            "title": "Headline"
          },
          "reposts": {
            "anyOf": [
              {
                "items": {
                  "maxLength": 2000,
                  "type": "string"
                },
                "maxItems": 3,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts"
          }
        },
        "title": "PartnerProfileChange",
        "type": "object"
      },
      "PartnerPurchaseRead": {
        "properties": {
          "billing_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Billing Status"
          },
          "checkout_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "More Accounts Stripe checkout URL. Open top-level/outside an iframe. Null outside checkout state.",
            "title": "Checkout Url"
          },
          "current_period_ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current subscription period end when available; not proof that every line ends then.",
            "title": "Current Period Ends At"
          },
          "customer_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Partner-scoped customer/company reference.",
            "title": "Customer Ref"
          },
          "email_access_state": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email Access State"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Authoritative expiry timestamp; countdowns should account for returned server_time when available.",
            "title": "Expires At"
          },
          "id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "lines": {
            "items": {
              "$ref": "#/components/schemas/PartnerLineRead"
            },
            "title": "Lines",
            "type": "array"
          },
          "monthly_subtotal_cents": {
            "description": "Monthly subtotal before volume discounts, in integer USD cents.",
            "title": "Monthly Subtotal Cents",
            "type": "integer"
          },
          "monthly_total_cents": {
            "description": "Authoritative monthly total after volume discounts, in integer USD cents.",
            "title": "Monthly Total Cents",
            "type": "integer"
          },
          "needs_email_verification": {
            "default": false,
            "title": "Needs Email Verification",
            "type": "boolean"
          },
          "needs_ops_review": {
            "default": false,
            "description": "Payment is confirmed but More Accounts review/fulfilment is still pending.",
            "title": "Needs Ops Review",
            "type": "boolean"
          },
          "next_monthly_total_cents": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Known next renewal amount, or null when not yet known. Integer USD cents.",
            "title": "Next Monthly Total Cents"
          },
          "paid": {
            "default": false,
            "description": "Canonical recorded payment confirmation. Not inferred from a redirect or iframe message.",
            "title": "Paid",
            "type": "boolean"
          },
          "paid_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Recorded payment timestamp, or null before payment confirmation.",
            "title": "Paid At"
          },
          "payment_ui_mode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The current payment presentation mode, or null before checkout starts.",
            "title": "Payment Ui Mode"
          },
          "receipts": {
            "items": {
              "$ref": "#/components/schemas/PartnerReceiptRead"
            },
            "title": "Receipts",
            "type": "array"
          },
          "server_time": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Server timestamp for expiry countdown calibration; may be null.",
            "title": "Server Time"
          },
          "state": {
            "title": "State",
            "type": "string"
          },
          "volume_discount_cents": {
            "description": "Server-calculated discount amount in integer USD cents.",
            "title": "Volume Discount Cents",
            "type": "integer"
          },
          "volume_discount_percent": {
            "description": "Server-calculated volume discount percentage.",
            "title": "Volume Discount Percent",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "state",
          "expires_at",
          "monthly_total_cents",
          "monthly_subtotal_cents",
          "volume_discount_percent",
          "volume_discount_cents",
          "lines"
        ],
        "title": "PartnerPurchaseRead",
        "type": "object"
      },
      "PartnerReceiptRead": {
        "properties": {
          "amount_paid_cents": {
            "title": "Amount Paid Cents",
            "type": "integer"
          },
          "branding": {
            "$ref": "#/components/schemas/PortalBrandRead"
          },
          "currency": {
            "title": "Currency",
            "type": "string"
          },
          "invoice_id": {
            "title": "Invoice Id",
            "type": "string"
          },
          "merchant_name": {
            "title": "Merchant Name",
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "title": "Order Id",
            "type": "string"
          },
          "paid_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Paid At"
          },
          "refunded_cents": {
            "default": 0,
            "title": "Refunded Cents",
            "type": "integer"
          },
          "tax_cents": {
            "title": "Tax Cents",
            "type": "integer"
          },
          "total_cents": {
            "title": "Total Cents",
            "type": "integer"
          }
        },
        "required": [
          "invoice_id",
          "order_id",
          "branding",
          "amount_paid_cents",
          "total_cents",
          "tax_cents",
          "currency",
          "merchant_name"
        ],
        "title": "PartnerReceiptRead",
        "type": "object"
      },
      "PartnerReply": {
        "additionalProperties": false,
        "examples": [
          {
            "changes": {
              "headline": "Approved revised headline"
            },
            "message": "Our company approved the revised wording."
          }
        ],
        "properties": {
          "changes": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PartnerProfileChange"
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "maxLength": 4000,
            "minLength": 1,
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "PartnerReply",
        "type": "object"
      },
      "PartnerSessionCreate": {
        "additionalProperties": false,
        "examples": [
          {
            "mode": "hosted"
          }
        ],
        "properties": {
          "mode": {
            "default": "hosted",
            "description": "hosted redirects to More Accounts; embedded uses its registered parent origin. Both share the same customer UI.",
            "enum": [
              "hosted",
              "embedded"
            ],
            "title": "Mode",
            "type": "string"
          },
          "parent_origin": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For embedded mode only: exact registered public HTTPS origin; no paths, wildcards or custom ports.",
            "title": "Parent Origin"
          }
        },
        "title": "PartnerSessionCreate",
        "type": "object"
      },
      "PartnerSessionRead": {
        "properties": {
          "expires_at": {
            "description": "Authoritative expiry timestamp; countdowns should account for returned server_time when available.",
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "mode": {
            "enum": [
              "hosted",
              "embedded"
            ],
            "title": "Mode",
            "type": "string"
          },
          "url": {
            "description": "Private two-hour customer capability. Redirect/embed exactly as returned; preserve its fragment, do not log it or send it to analytics. This is not a partner API credential.",
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "id",
          "url",
          "mode",
          "expires_at"
        ],
        "title": "PartnerSessionRead",
        "type": "object"
      },
      "PartnerSettlementPage": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PartnerSettlementRead"
            },
            "title": "Items",
            "type": "array"
          },
          "page": {
            "title": "Page",
            "type": "integer"
          },
          "page_size": {
            "title": "Page Size",
            "type": "integer"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "page",
          "page_size"
        ],
        "title": "PartnerSettlementPage",
        "type": "object"
      },
      "PartnerSettlementRead": {
        "properties": {
          "amount_cents": {
            "title": "Amount Cents",
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "method": {
            "title": "Method",
            "type": "string"
          },
          "paid_at": {
            "description": "Recorded payment timestamp, or null before payment confirmation.",
            "format": "date-time",
            "title": "Paid At",
            "type": "string"
          },
          "reference": {
            "title": "Reference",
            "type": "string"
          },
          "void_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reason supplied by More Accounts for correcting the receipt record.",
            "title": "Void Reason"
          },
          "voided_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "A voided receipt remains in history but no longer counts as settled. Voiding does not reverse an external transfer.",
            "title": "Voided At"
          }
        },
        "required": [
          "id",
          "amount_cents",
          "method",
          "reference",
          "paid_at",
          "voided_at",
          "void_reason"
        ],
        "title": "PartnerSettlementRead",
        "type": "object"
      },
      "PortalBrandRead": {
        "properties": {
          "background_color": {
            "title": "Background Color",
            "type": "string"
          },
          "display_name": {
            "title": "Display Name",
            "type": "string"
          },
          "foreground": {
            "title": "Foreground",
            "type": "string"
          },
          "icon_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon Url"
          },
          "logo_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Logo Url"
          },
          "primary_color": {
            "title": "Primary Color",
            "type": "string"
          },
          "primary_foreground": {
            "title": "Primary Foreground",
            "type": "string"
          },
          "privacy_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Privacy Url"
          },
          "support_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Support Url"
          },
          "terms_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Terms Url"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "display_name",
          "primary_color",
          "primary_foreground",
          "background_color",
          "foreground"
        ],
        "title": "PortalBrandRead",
        "type": "object"
      },
      "PortalCredential": {
        "properties": {
          "password": {
            "title": "Password",
            "type": "string"
          },
          "totp_configured": {
            "title": "Totp Configured",
            "type": "boolean"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "username",
          "password",
          "totp_configured"
        ],
        "title": "PortalCredential",
        "type": "object"
      },
      "PortalHandover": {
        "properties": {
          "access_enabled": {
            "default": false,
            "title": "Access Enabled",
            "type": "boolean"
          },
          "blockers": {
            "items": {
              "type": "string"
            },
            "title": "Blockers",
            "type": "array"
          },
          "credentials_available": {
            "title": "Credentials Available",
            "type": "boolean"
          },
          "handed_back_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Handed Back At"
          },
          "minimum_days": {
            "$ref": "#/components/schemas/PortalHandoverProgress"
          },
          "observed_connections": {
            "$ref": "#/components/schemas/PortalHandoverProgress"
          },
          "ready_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ready At"
          },
          "status": {
            "enum": [
              "warming_up",
              "ready",
              "handback_pending",
              "handed_back"
            ],
            "title": "Status",
            "type": "string"
          },
          "successful_warmup_days": {
            "$ref": "#/components/schemas/PortalHandoverProgress"
          }
        },
        "required": [
          "status",
          "blockers",
          "minimum_days",
          "successful_warmup_days",
          "observed_connections",
          "ready_at",
          "handed_back_at",
          "credentials_available"
        ],
        "title": "PortalHandover",
        "type": "object"
      },
      "PortalHandoverCredentials": {
        "properties": {
          "linkedin": {
            "$ref": "#/components/schemas/PortalCredential"
          },
          "proxy": {
            "$ref": "#/components/schemas/PortalProxyCredential"
          },
          "warning": {
            "title": "Warning",
            "type": "string"
          }
        },
        "required": [
          "linkedin",
          "proxy",
          "warning"
        ],
        "title": "PortalHandoverCredentials",
        "type": "object"
      },
      "PortalHandoverProgress": {
        "properties": {
          "current": {
            "title": "Current",
            "type": "integer"
          },
          "met": {
            "title": "Met",
            "type": "boolean"
          },
          "target": {
            "title": "Target",
            "type": "integer"
          }
        },
        "required": [
          "current",
          "target",
          "met"
        ],
        "title": "PortalHandoverProgress",
        "type": "object"
      },
      "PortalProxyCredential": {
        "properties": {
          "host": {
            "title": "Host",
            "type": "string"
          },
          "password": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Password"
          },
          "port": {
            "title": "Port",
            "type": "integer"
          },
          "scheme": {
            "title": "Scheme",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "scheme",
          "host",
          "port",
          "username",
          "password"
        ],
        "title": "PortalProxyCredential",
        "type": "object"
      },
      "PortalTotpCode": {
        "properties": {
          "code": {
            "title": "Code",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "period_seconds": {
            "title": "Period Seconds",
            "type": "integer"
          },
          "seconds_remaining": {
            "title": "Seconds Remaining",
            "type": "integer"
          }
        },
        "required": [
          "code",
          "period_seconds",
          "expires_at",
          "seconds_remaining"
        ],
        "title": "PortalTotpCode",
        "type": "object"
      },
      "ProfileBannerPreference": {
        "additionalProperties": false,
        "properties": {
          "source": {
            "enum": [
              "company",
              "custom"
            ],
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "source"
        ],
        "title": "ProfileBannerPreference",
        "type": "object"
      },
      "ProfileBannerPreferenceRead": {
        "properties": {
          "banner_source": {
            "enum": [
              "company",
              "custom"
            ],
            "title": "Banner Source",
            "type": "string"
          },
          "request": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PartnerChangeRead"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "banner_source",
          "request"
        ],
        "title": "ProfileBannerPreferenceRead",
        "type": "object"
      },
      "ProfileTextBranding": {
        "properties": {
          "company_value": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company Value"
          },
          "source": {
            "enum": [
              "company",
              "custom"
            ],
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "source",
          "company_value"
        ],
        "title": "ProfileTextBranding",
        "type": "object"
      },
      "RequestedProfileChanges": {
        "properties": {
          "about": {
            "title": "About",
            "type": "string"
          },
          "banner_asset_id": {
            "title": "Banner Asset Id",
            "type": "string"
          },
          "education": {
            "items": {
              "$ref": "#/components/schemas/EducationEntry"
            },
            "maxItems": 6,
            "title": "Education",
            "type": "array"
          },
          "experience": {
            "items": {
              "$ref": "#/components/schemas/ExperienceEntry"
            },
            "maxItems": 12,
            "title": "Experience",
            "type": "array"
          },
          "featured": {
            "items": {
              "maxLength": 2000,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Featured",
            "type": "array"
          },
          "headline": {
            "title": "Headline",
            "type": "string"
          },
          "photo_asset_id": {
            "title": "Photo Asset Id",
            "type": "string"
          },
          "reposts": {
            "items": {
              "maxLength": 2000,
              "type": "string"
            },
            "maxItems": 3,
            "minItems": 1,
            "title": "Reposts",
            "type": "array"
          }
        },
        "title": "RequestedProfileChanges",
        "type": "object"
      },
      "RestrictionReport": {
        "additionalProperties": false,
        "properties": {
          "observation": {
            "maxLength": 500,
            "minLength": 1,
            "title": "Observation",
            "type": "string"
          }
        },
        "required": [
          "observation"
        ],
        "title": "RestrictionReport",
        "type": "object"
      },
      "RestrictionStatusRead": {
        "properties": {
          "decision": {
            "anyOf": [
              {
                "enum": [
                  "refund",
                  "replacement",
                  "no_action"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decision"
          },
          "status": {
            "enum": [
              "open",
              "awaiting_supplier",
              "decision_recorded",
              "closed"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "RestrictionStatusRead",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      }
    },
    "securitySchemes": {
      "PartnerBearer": {
        "description": "Server-side partner API key issued by More Accounts. Not a customer-session token or browser cookie. Every mutation additionally requires Idempotency-Key and X-Partner-Actor.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "More Accounts supplies and operates LinkedIn profiles, collects customer payments through its Stripe account, handles profile changes and customer support, and accounts for the reseller's agreed recurring commission. Call this API from the partner backend. Choose own-UI integration or create a two-hour hosted/embedded customer session. Obtain partner credentials, commercial terms and approved test context from More Accounts before activation. Never send the server-side partner API key to a browser. Direct account access is optional and requires a per-profile More Accounts Owner grant; paid status alone does not enable it.",
    "title": "More Accounts partner API",
    "version": "1"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/partners/v1/branding": {
      "get": {
        "operationId": "read_branding_api_partners_v1_branding_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/PortalBrandRead"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Response Read Branding Api Partners V1 Branding Get"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read Branding",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/catalog": {
      "get": {
        "description": "List eligible partner profiles. Availability can change before reservation. Country matches the returned country case-insensitively. Location searches the full supplier location and structured city, region and country without case sensitivity. Verification matches the returned method exactly. New listings require a verification result and an exact connection count or reported range. A supplier-wide verification guarantee covers offers without an individual result. The verified filter accepts true or false. The compatibility value unknown returns no listings. A range meets min_connections when its lower bound meets the threshold.",
        "operationId": "catalog_profiles_api_partners_v1_catalog_get",
        "parameters": [
          {
            "description": "One-based page number. Array-returning endpoints do not wrap results with totals.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Items per page, at most 100. Statement totals cover all pages.",
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "country",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Country"
            }
          },
          {
            "in": "query",
            "name": "location",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Location"
            }
          },
          {
            "in": "query",
            "name": "verification",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Verification"
            }
          },
          {
            "in": "query",
            "name": "verified",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "const": "unknown",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Verified"
            }
          },
          {
            "in": "query",
            "name": "min_connections",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "minimum": 0,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Min Connections"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogPageRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "List eligible profiles",
        "tags": [
          "Catalogue"
        ]
      }
    },
    "/api/partners/v1/commissions": {
      "get": {
        "description": "USD integer cents. Lifetime statement totals include all invoices, independent of pagination. available_cents is before receipt deductions; use outstanding_cents for the remaining balance after recorded payments. Refunds or holds after payout can make it negative. Rate is snapshotted per subscription. No money is moved by this endpoint.",
        "operationId": "commissions_api_partners_v1_commissions_get",
        "parameters": [
          {
            "description": "One-based page number. Array-returning endpoints do not wrap results with totals.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Items per page, at most 100. Statement totals cover all pages.",
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerCommissionRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read invoice-backed commission",
        "tags": [
          "Commissions"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}": {
      "put": {
        "description": "Bind a stable company reference from your own application to this partner. Authorize the actor's company access on your backend first. Matching an email never grants access to an existing customer team. Requires company, owner_name, owner_email and a business_brief.",
        "operationId": "put_customer_api_partners_v1_customers__customer_ref__put",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerCustomerPut"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerCustomerRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Create or update a company binding",
        "tags": [
          "Customers"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/assets": {
      "post": {
        "description": "Use multipart field file for a PNG, JPEG or WebP image up to 8 MB. Send the returned asset ID as banner_asset_id for this customer.",
        "operationId": "upload_banner_api_partners_v1_customers__customer_ref__assets_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_banner_api_partners_v1_customers__customer_ref__assets_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAssetRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Upload a private profile image",
        "tags": [
          "Profile changes"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/assets/{asset_id}": {
      "get": {
        "description": "Read image bytes belonging to this partner/customer binding. Not a public image URL and not a JSON response. Supply the partner bearer header.",
        "operationId": "read_banner_api_partners_v1_customers__customer_ref__assets__asset_id__get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "asset_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Asset Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "image/jpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "image/png": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "image/webp": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read a customer’s private profile image",
        "tags": [
          "Profile changes"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/cart": {
      "get": {
        "description": "Resume the customer's current checkout or shopping cart. An empty cart has id=null and lines=[]. Server prices and expiry are authoritative. Shopping holds last 15 minutes; a checkout freezes its selection.",
        "operationId": "read_cart_api_partners_v1_customers__customer_ref__cart_get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read the current cart or checkout",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/cart/items": {
      "post": {
        "description": "Reserve a published, ready inventory profile using its inventory profile ID. Returns the cart with separate line IDs. Refresh inventory after an availability conflict. A customer can select 1–100 exact profiles with mixed prices.",
        "operationId": "add_item_api_partners_v1_customers__customer_ref__cart_items_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CartItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Reserve a profile in the cart",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/cart/items/{line_id}": {
      "delete": {
        "description": "Remove the selection identified by its cart line ID. This is not the inventory ID. A checkout selection must be resumed or cancelled before editing; paid lines use period-end cancellation.",
        "operationId": "remove_item_api_partners_v1_customers__customer_ref__cart_items__line_id__delete",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Remove an unpaid shopping selection",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/change-requests": {
      "get": {
        "description": "Returns an array. Display message, messages history and next_step. A needs_information request requires a customer reply. Completion requires More Accounts verification.",
        "operationId": "change_requests_api_partners_v1_customers__customer_ref__change_requests_get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "One-based page number. Array-returning endpoints do not wrap results with totals.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Items per page, at most 100. Statement totals cover all pages.",
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PartnerChangeRead"
                  },
                  "title": "Response Change Requests Api Partners V1 Customers  Customer Ref  Change Requests Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "List customer change requests",
        "tags": [
          "Profile changes"
        ]
      },
      "post": {
        "description": "Send a paid line_id with at least one of its allowed_change_fields. Omit unchanged fields. An empty About clears its text. A supplied Experience or Education list replaces the section and an empty list clears it. Changes are reviewed before updating the recorded profile.",
        "operationId": "create_change_api_partners_v1_customers__customer_ref__change_requests_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerChangeCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerChangeRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Request permitted profile changes",
        "tags": [
          "Profile changes"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/change-requests/{request_id}": {
      "get": {
        "description": "Read only a request belonging to this partner/customer. States: submitted, in_progress, needs_information, completed, failed and cancelled.",
        "operationId": "change_request_api_partners_v1_customers__customer_ref__change_requests__request_id__get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Request Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerChangeRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read a change request",
        "tags": [
          "Profile changes"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/change-requests/{request_id}/replies": {
      "post": {
        "description": "Reply to a needs_information request with a non-empty message and optional permitted changes. Updated fields amend the existing request while preserving earlier inputs and history.",
        "operationId": "reply_api_partners_v1_customers__customer_ref__change_requests__request_id__replies_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Request Id",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerReply"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerChangeRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Reply to a customer follow-up",
        "tags": [
          "Profile changes"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/checkout": {
      "post": {
        "description": "Collect explicit customer consent and permitted activities before this mutation. Server pricing and commission apply; do not send a price or return URL. Redirect to checkout_url. The partner's registered return URL receives moreaccounts_order_id. A redirect is not payment confirmation. After uncertainty, retry this same persisted logical command or read/reconcile its purchase; do not create another checkout intent.",
        "operationId": "checkout_api_partners_v1_customers__customer_ref__checkout_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerCheckout"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Start Stripe checkout",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/checkout/cancel": {
      "post": {
        "description": "Expire the provider checkout before releasing held inventory. If payment wins the cancellation race, the purchase continues through the paid workflow. Read the returned state rather than assuming cancellation succeeded.",
        "operationId": "cancel_checkout_api_partners_v1_customers__customer_ref__checkout_cancel_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Cancel an unpaid checkout",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases": {
      "get": {
        "description": "Returns an array, not a pagination envelope. Read line service_state and allowed_change_fields in addition to the purchase's paid and needs_ops_review fields.",
        "operationId": "purchases_api_partners_v1_customers__customer_ref__purchases_get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "One-based page number. Array-returning endpoints do not wrap results with totals.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Items per page, at most 100. Statement totals cover all pages.",
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PartnerPurchaseRead"
                  },
                  "title": "Response Purchases Api Partners V1 Customers  Customer Ref  Purchases Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "List paid purchases",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}": {
      "get": {
        "description": "Read an order owned by this partner/customer. Payment can be confirmed while fulfilment still awaits More Accounts review. Initial changes may remain configuring; never infer readiness from payment alone.",
        "operationId": "purchase_api_partners_v1_customers__customer_ref__purchases__order_id__get",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read a purchase",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/access": {
      "get": {
        "operationId": "account_access_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__access_get",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PortalHandover"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Account Access",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/access/accept": {
      "post": {
        "operationId": "accept_account_access_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__access_accept_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PortalHandover"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Accept Account Access",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/access/reveal": {
      "post": {
        "operationId": "reveal_account_access_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__access_reveal_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PortalHandoverCredentials"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Reveal Account Access",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/access/totp": {
      "post": {
        "operationId": "account_access_totp_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__access_totp_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PortalTotpCode"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Account Access Totp",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/banner-preference": {
      "post": {
        "description": "Set source=custom to exclude this profile from company-wide banner requests without changing its current banner. Set source=company to restore inheritance; a different configured banner creates an ordinary reviewed and independently verified change request. Rejects profiles with open requests or unavailable managed changes. Only a native customer owner can configure the company-wide default in Settings.",
        "operationId": "banner_preference_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__banner_preference_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileBannerPreference"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileBannerPreferenceRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Choose a custom or company banner for a purchased profile",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/cancel": {
      "post": {
        "description": "Schedule this purchased line to end at its paid period's end. This is not an immediate inventory release, refund, or cancellation of all other lines. Use the purchased line ID, not inventory ID.",
        "operationId": "cancel_profile_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__cancel_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Schedule one profile's period-end cancellation",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/disconnects": {
      "post": {
        "description": "Report a disconnected sender. Repeated reports for the same profile and outreach tool return its open ticket.",
        "operationId": "partner_disconnect_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__disconnects_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConnectionReport"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectionStatusRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Partner Disconnect",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/refund": {
      "post": {
        "operationId": "request_refund_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__refund_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Request Refund",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/replacement": {
      "post": {
        "operationId": "choose_replacement_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__replacement_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CatalogSupplierReplacement"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Choose Replacement",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/replacement-options": {
      "get": {
        "operationId": "replacement_options_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__replacement_options_get",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/CatalogProfileRead"
                  },
                  "title": "Response Replacement Options Api Partners V1 Customers  Customer Ref  Purchases  Order Id  Profiles  Line Id  Replacement Options Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Replacement Options",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/profiles/{line_id}/restriction": {
      "post": {
        "description": "Report an observed restriction on the purchased profile. Repeated reports on the same selection share its case. Taskforce contacts the supplier and records the outcome.",
        "operationId": "partner_restriction_api_partners_v1_customers__customer_ref__purchases__order_id__profiles__line_id__restriction_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "line_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Line Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RestrictionReport"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "status": {
                      "enum": [
                        "open",
                        "awaiting_supplier",
                        "decision_recorded",
                        "closed"
                      ],
                      "title": "Status",
                      "type": "string"
                    }
                  },
                  "required": [
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Report a profile restriction",
        "tags": [
          "partner-api"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/purchases/{order_id}/reconcile": {
      "post": {
        "description": "Recheck provider/canonical payment state after a delayed return or uncertain response. This is a mutation and requires both mutation headers. A failed provider read does not prove that payment failed.",
        "operationId": "reconcile_purchase_api_partners_v1_customers__customer_ref__purchases__order_id__reconcile_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Order Id",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerPurchaseRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Reconcile canonical payment state",
        "tags": [
          "Purchases"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/sessions": {
      "post": {
        "description": "After binding the company, create a two-hour customer capability. Hosted mode needs no parent_origin. Embedded mode requires an exact registered public HTTPS parent_origin. Redirect/embed the returned URL unchanged. Keep it private and out of logs/analytics; it permits purchases and service changes for the bound company. No customer consent or charge is created by this request. A fresh session needs a new logical command key.",
        "operationId": "customer_session_api_partners_v1_customers__customer_ref__sessions_post",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerSessionCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerSessionRead"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Create a hosted or embedded customer session",
        "tags": [
          "Customer pages"
        ]
      }
    },
    "/api/partners/v1/customers/{customer_ref}/sessions/{session_id}": {
      "delete": {
        "description": "Revoke this customer's session. Disabling the integration/customer pages also blocks access; rotating the partner API key permanently revokes already-issued sessions. Reusing a session-creation idempotency key can replay the original revoked/expired result.",
        "operationId": "revoke_customer_session_api_partners_v1_customers__customer_ref__sessions__session_id__delete",
        "parameters": [
          {
            "description": "Opaque, stable company reference in your partner namespace.",
            "example": "company-123",
            "in": "path",
            "name": "customer_ref",
            "required": true,
            "schema": {
              "title": "Customer Ref",
              "type": "string"
            }
          },
          {
            "description": "Resource UUID returned by this API in the same customer scope. Do not substitute an inventory ID for a purchased/cart line ID.",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Session Id",
              "type": "string"
            }
          },
          {
            "description": "Persisted identifier for one logical mutation. Keep method, path, body, actor and key identical on uncertain retries; new intents use new keys.",
            "example": "66666666-6666-4666-8666-666666666666",
            "in": "header",
            "name": "idempotency-key",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 8,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "description": "Stable authenticated user reference from the partner backend. Authorize company access there; never trust a client-supplied identity alone.",
            "example": "user-456",
            "in": "header",
            "name": "x-partner-actor",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "title": "X-Partner-Actor",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Revoke a customer session",
        "tags": [
          "Customer pages"
        ]
      }
    },
    "/api/partners/v1/settlements": {
      "get": {
        "description": "Read paginated receipts recorded by More Accounts after an external payment completes. Includes voided records, which remain in history but do not count as settled. Recording or voiding is not a bank transfer; the partner API has no endpoint for initiating payouts.",
        "operationId": "partner_settlements_api_partners_v1_settlements_get",
        "parameters": [
          {
            "description": "One-based page number. Array-returning endpoints do not wrap results with totals.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Items per page, at most 100. Statement totals cover all pages.",
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerSettlementPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerAPIError"
                }
              }
            },
            "description": "See the detail and integration guide for recovery. Do not discard persisted mutation keys after an uncertain response."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "PartnerBearer": []
          }
        ],
        "summary": "Read completed manual payment records",
        "tags": [
          "Commissions"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Production origin. Paths already include /api/partners/v1. Use only an environment and test procedure approved by More Accounts.",
      "url": "https://app.moreaccounts.com"
    }
  ],
  "tags": [
    {
      "name": "Customers"
    },
    {
      "name": "Customer pages"
    },
    {
      "name": "Catalogue"
    },
    {
      "name": "Purchases"
    },
    {
      "name": "Profile changes"
    },
    {
      "name": "Commissions"
    },
    {
      "name": "Status webhooks"
    }
  ],
  "webhooks": {
    "partnerStatus": {
      "post": {
        "description": "Delivered to the HTTPS URL configured with More Accounts. Verify HMAC-SHA256 over timestamp + '.' + raw body bytes with the webhook signing secret, using a five-minute timestamp window and constant-time comparison. X-Partner-Event-Id is diagnostic; trust the verified body's id. Persist/deduplicate before acknowledging 2xx. Retried deliveries and replays preserve event ID. No partner bearer key is sent to your receiver.",
        "parameters": [
          {
            "in": "header",
            "name": "X-Partner-Event-Id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "description": "t=<Unix seconds>,v1=<hex HMAC SHA256>. Use the webhook signing secret, not the API key.",
            "in": "header",
            "name": "X-Partner-Signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerEventEnvelope"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Verified event durably received or already received."
          },
          "401": {
            "description": "Invalid or stale signature; event was not trusted."
          }
        },
        "security": [],
        "summary": "Receive a More Accounts status event",
        "tags": [
          "Status webhooks"
        ]
      }
    }
  }
}
