{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "/schemas/3.1.0-rc.4/account/sync-accounts-response.json",
  "title": "Sync Accounts Response",
  "description": "Response from account sync operation. Returns per-account results with status and billing, or operation-level errors on complete failure.",
  "type": "object",
  "allOf": [
    {
      "$ref": "/schemas/3.1.0-rc.4/core/version-envelope.json"
    },
    {
      "$ref": "/schemas/3.1.0-rc.4/core/protocol-envelope.json"
    }
  ],
  "oneOf": [
    {
      "title": "SyncAccountsSuccess",
      "description": "Sync operation processed accounts (individual accounts may be pending or have action=failed)",
      "type": "object",
      "properties": {
        "dry_run": {
          "type": "boolean",
          "description": "Whether this was a dry run (no actual changes made)"
        },
        "accounts": {
          "type": "array",
          "description": "Results for each account processed",
          "items": {
            "type": "object",
            "properties": {
              "account_id": {
                "type": "string",
                "description": "Seller-assigned account identifier. Use this in subsequent create_media_buy and other account-scoped operations when the seller's account model uses account_id references. For buyer-declared accounts, this may be echoed as the seller's internal handle, but the seller MUST continue accepting the natural-key AccountRef for subsequent calls.",
                "x-entity": "account"
              },
              "brand": {
                "$ref": "/schemas/3.1.0-rc.4/core/brand-ref.json",
                "description": "Brand reference, echoed from the request"
              },
              "operator": {
                "type": "string",
                "description": "Operator domain, echoed from request"
              },
              "name": {
                "type": "string",
                "description": "Human-readable account name assigned by the seller"
              },
              "action": {
                "type": "string",
                "enum": [
                  "created",
                  "updated",
                  "unchanged",
                  "failed"
                ],
                "description": "Action taken for this account. created: new account provisioned. updated: existing account modified. unchanged: no changes needed. failed: could not process (see errors)."
              },
              "status": {
                "type": "string",
                "enum": [
                  "active",
                  "pending_approval",
                  "rejected",
                  "payment_required",
                  "suspended",
                  "closed"
                ],
                "description": "Account status. active: ready for use. pending_approval: seller reviewing (credit, legal). rejected: seller declined the account request. payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: was active, now terminated."
              },
              "billing": {
                "$ref": "/schemas/3.1.0-rc.4/enums/billing-party.json",
                "description": "Who is invoiced on this account. Matches the requested billing model."
              },
              "billing_entity": {
                "$ref": "/schemas/3.1.0-rc.4/core/business-entity.json",
                "description": "Business entity details for the party responsible for payment, echoed from the request. Sellers MAY add fields the agent omitted (e.g., filling in registration_number from a credit check), but MUST NOT return data from a different entity. Bank details are omitted (write-only)."
              },
              "account_scope": {
                "$ref": "/schemas/3.1.0-rc.4/enums/account-scope.json"
              },
              "setup": {
                "type": "object",
                "description": "Setup information for pending accounts. Provides the agent (or human) with next steps to complete account activation.",
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "description": "URL where the human can complete the required action (credit application, legal agreement, add funds)"
                  },
                  "message": {
                    "type": "string",
                    "description": "Human-readable description of what's needed"
                  },
                  "expires_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "When this setup link expires"
                  }
                },
                "required": [
                  "message"
                ],
                "additionalProperties": true
              },
              "rate_card": {
                "type": "string",
                "description": "Rate card applied to this account"
              },
              "payment_terms": {
                "$ref": "/schemas/3.1.0-rc.4/enums/payment-terms.json",
                "description": "Payment terms agreed for this account. When the account is active, these are the binding terms for all invoices on this account."
              },
              "credit_limit": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "number",
                    "minimum": 0
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$"
                  }
                },
                "required": [
                  "amount",
                  "currency"
                ]
              },
              "errors": {
                "type": "array",
                "description": "Per-account errors (only present when action is 'failed')",
                "items": {
                  "$ref": "/schemas/3.1.0-rc.4/core/error.json"
                }
              },
              "warnings": {
                "type": "array",
                "description": "Non-fatal warnings about this account",
                "items": {
                  "type": "string"
                }
              },
              "sandbox": {
                "type": "boolean",
                "description": "Whether this is a sandbox account, echoed from the request. Only present for buyer-declared accounts."
              },
              "notification_configs": {
                "type": "array",
                "description": "Applied notification subscribers for this account after declarative replacement and activation-proof checks. Present on `created`, `updated`, and `unchanged` results when the buyer included `notification_configs` in the request or any persisted entries exist on the account. Entries are keyed by account-scoped `subscriber_id`; re-sending an existing `subscriber_id` replaces that subscriber's config rather than creating a duplicate. Only configs that the seller has persisted are echoed. `authentication.credentials` is omitted on every entry (write-only).",
                "items": {
                  "$ref": "/schemas/3.1.0-rc.4/core/notification-config.json"
                },
                "maxItems": 16
              },
              "authorization": {
                "$ref": "/schemas/3.1.0-rc.4/core/account-authorization.json",
                "description": "Optional. The caller's scope grant against this account after the sync operation. Vendor agents of any type (media-buy, signals, governance, creative, brand) that support scope introspection SHOULD populate this so callers can preempt RBAC errors rather than discovering scope by trial and error. Media-buy sales agents claiming the `attestation_verifier` standard scope MUST populate it. Present on `created`, `updated`, and `unchanged` results; omitted on `failed` results (where the account did not reach a usable state). Absence means the vendor agent does not advertise introspectable scope — callers MUST NOT infer access from absence."
              }
            },
            "required": [
              "brand",
              "operator",
              "action",
              "status"
            ],
            "additionalProperties": true
          }
        },
        "context": {
          "$ref": "/schemas/3.1.0-rc.4/core/context.json"
        },
        "ext": {
          "$ref": "/schemas/3.1.0-rc.4/core/ext.json"
        }
      },
      "required": [
        "accounts"
      ],
      "additionalProperties": true,
      "not": {
        "required": [
          "errors"
        ]
      }
    },
    {
      "title": "SyncAccountsError",
      "description": "Operation failed completely, no accounts were processed",
      "type": "object",
      "properties": {
        "errors": {
          "type": "array",
          "description": "Operation-level errors (e.g., authentication failure, service unavailable)",
          "items": {
            "$ref": "/schemas/3.1.0-rc.4/core/error.json"
          },
          "minItems": 1
        },
        "context": {
          "$ref": "/schemas/3.1.0-rc.4/core/context.json"
        },
        "ext": {
          "$ref": "/schemas/3.1.0-rc.4/core/ext.json"
        }
      },
      "required": [
        "errors"
      ],
      "additionalProperties": true,
      "not": {
        "anyOf": [
          {
            "required": [
              "accounts"
            ]
          },
          {
            "required": [
              "dry_run"
            ]
          }
        ]
      }
    }
  ],
  "examples": [
    {
      "description": "Mixed results — one active, one pending approval",
      "data": {
        "status": "completed",
        "accounts": [
          {
            "account_id": "acc_spark_001",
            "brand": {
              "domain": "nova-brands.com",
              "brand_id": "spark"
            },
            "operator": "pinnacle-media.com",
            "name": "Spark (via Pinnacle)",
            "action": "created",
            "status": "active",
            "billing": "operator",
            "account_scope": "operator_brand"
          },
          {
            "account_id": "acc_glow_pending",
            "brand": {
              "domain": "nova-brands.com",
              "brand_id": "glow"
            },
            "operator": "pinnacle-media.com",
            "name": "Glow",
            "action": "created",
            "status": "pending_approval",
            "billing": "operator",
            "account_scope": "operator_brand",
            "setup": {
              "url": "https://seller.example.com/advertiser-onboard",
              "message": "Complete advertiser registration and credit application",
              "expires_at": "2026-03-10T00:00:00Z"
            }
          }
        ]
      }
    },
    {
      "description": "Rejected account — no account_id assigned",
      "data": {
        "status": "completed",
        "accounts": [
          {
            "brand": {
              "domain": "acme-corp.com",
              "brand_id": "clearance"
            },
            "operator": "acme-corp.com",
            "action": "created",
            "status": "rejected",
            "warnings": [
              "Account request declined: advertiser category not accepted on this platform."
            ]
          }
        ]
      }
    },
    {
      "description": "Unsupported billing — seller rejects the request",
      "data": {
        "status": "completed",
        "accounts": [
          {
            "brand": {
              "domain": "acme-corp.com"
            },
            "operator": "acme-corp.com",
            "action": "failed",
            "status": "rejected",
            "errors": [
              {
                "code": "BILLING_NOT_SUPPORTED",
                "message": "Operator billing is not supported. This seller only accepts agent billing."
              }
            ]
          }
        ]
      }
    },
    {
      "description": "Advertiser billed directly with billing entity (bank details omitted in response)",
      "data": {
        "status": "completed",
        "accounts": [
          {
            "account_id": "acc_acme_direct_bill",
            "brand": {
              "domain": "acme-corp.com"
            },
            "operator": "pinnacle-media.com",
            "name": "Acme Corp (billed direct)",
            "action": "created",
            "status": "active",
            "billing": "advertiser",
            "billing_entity": {
              "legal_name": "Acme Corporation GmbH",
              "vat_id": "DE987654321",
              "registration_number": "HRB 67890",
              "address": {
                "street": "Hauptstrasse 42",
                "city": "Munich",
                "postal_code": "80331",
                "country": "DE"
              },
              "contacts": [
                {
                  "role": "billing",
                  "name": "AP Department",
                  "email": "billing@acme-corp.com"
                }
              ]
            },
            "account_scope": "operator_brand",
            "payment_terms": "net_30"
          }
        ]
      }
    },
    {
      "description": "Unsupported payment terms — seller rejects the request",
      "data": {
        "status": "completed",
        "accounts": [
          {
            "brand": {
              "domain": "acme-corp.com"
            },
            "operator": "acme-corp.com",
            "action": "failed",
            "status": "rejected",
            "errors": [
              {
                "code": "PAYMENT_TERMS_NOT_SUPPORTED",
                "message": "Net-60 payment terms are not available. Omit payment_terms to accept this seller's default terms (net_30)."
              }
            ]
          }
        ]
      }
    }
  ],
  "properties": {}
}