overlay: 1.0.0
info:
  title: API Evangelist enhancements for Zoopla Premium Listing Activations API
  version: 1.0.0
extends: openapi/zoopla-premium-listing-activations-openapi.json
x-apievangelist:
  generated: '2026-07-26'
  method: generated
  source: derived from the harvested spec plus the searched artifacts in this repo
  note: Additive only. Records what API Evangelist established about this contract; the harvested spec is never
    mutated.
actions:
- target: $.info
  update:
    x-apievangelist-provider: alto-vebra
    x-apievangelist-generated: '2026-07-26'
    x-apievangelist-artifacts:
      authentication: authentication/alto-vebra-authentication.yml
      scopes: scopes/alto-vebra-scopes.yml
      conventions: conventions/alto-vebra-conventions.yml
      errors: errors/alto-vebra-problem-types.yml
      lifecycle: lifecycle/alto-vebra-lifecycle.yml
      conformance: conformance/alto-vebra-conformance.yml
      sandbox: sandbox/alto-vebra-sandbox.yml
      data_model: data-model/alto-vebra-data-model.yml
    x-apievangelist-access:
      gate: partner-only
      self_serve_signup: false
      note: The contract is anonymous and public; credentials require a Vebra Solutions contract, an integration
        registered in Alto Connect and per-agency activation.
    x-apievangelist-async:
      style: accepted-then-poll
      post_status:
      - 202
      - 303
      patch_status: 202
      note: POST queues the activation; poll GET /products/premium-listings/{uuid} for the terminal state. Processor
        failures surface as 102xxxx codes, not on the original POST.
    x-apievangelist-error-register:
      artifact: errors/alto-vebra-error-codes.yml
      codes: 46
      docs: https://developers.zoopla.co.uk/docs/premium-listings-error-codes-register
    x-apievangelist-quality-gates:
      full_description_min_chars: 200
      min_images: 3
      custom_details_max: 640kb
      note: Editorial policy enforced as API errors (1011007, 1011008, 1011009).
    x-apievangelist-billable: true