API Evangelist enhancements for Domain Group Listings API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Domain Group Listings API
  version: 1.0.0
extends: openapi/domain-group-listings-api-openapi.yml
generated: '2026-10-21'
method: generated
actions:
- target: $.info
  update:
    x-apievangelist-provider: domain-group
    x-apievangelist-provider-name: Domain Group
    x-apievangelist-country: AU
    x-apievangelist-industry: Real Estate
    x-apievangelist-portal: https://developer.domain.com.au/
    x-apievangelist-spec-source: https://developer.domain.com.au/static/latest/media/latest/openapi.json
    x-apievangelist-artifacts:
      authentication: authentication/domain-group-authentication.yml
      scopes: scopes/domain-group-scopes.yml
      conventions: conventions/domain-group-conventions.yml
      errors: errors/domain-group-problem-types.yml
      lifecycle: lifecycle/domain-group-lifecycle.yml
      sandbox: sandbox/domain-group-sandbox.yml
      webhooks: asyncapi/domain-group-webhooks.yml
      data_model: data-model/domain-group-data-model.yml
      agentic_access: agentic-access/domain-group-agentic-access.yml
      mcp: mcp/domain-group-mcp.yml
      llms: llms/domain-group-llms.txt
- target: $.servers
  update:
  - url: https://api.domain.com.au/
    description: Primary
    x-apievangelist-environment: production
  - url: https://api.domain.com.au/sandbox/
    description: Sandbox
    x-apievangelist-environment: sandbox
    x-apievangelist-sandbox-note: Write-testing only; data refreshed every Sunday. See sandbox/domain-group-sandbox.yml.
- target: $.components.securitySchemes.apikey
  update:
    x-apievangelist-note: API keys cannot reach user-specific data. Domain recommends OAuth 2.0 wherever a secret
      can be stored server-side.
    x-apievangelist-docs: https://developer.domain.com.au/docs/latest/authentication
- target: $.components.securitySchemes.oauth2
  update:
    x-apievangelist-note: The Authorization Code flow is required for any call that needs user context (agency-scoped
      webhook subscriptions, /v1/me). Client Credentials covers machine-to-machine reads.
    x-apievangelist-openid-configuration: https://auth.domain.com.au/v1/.well-known/openid-configuration
    x-apievangelist-pkce: S256 supported
- target: $.paths
  update:
    x-apievangelist-pagination:
      style: page-number
      params:
      - pageNumber
      - pageSize
      default_page_size: 20
      max_page_size: 100
      total_header: X-Total-Count
    x-apievangelist-rate-limit-headers:
    - X-Quota-PerMinute-Limit
    - X-Quota-PerMinute-Remaining
    - X-Quota-PerDay-Limit
    - X-Quota-PerDay-Remaining
    - Retry-After
    - X-Quota-Exceeded
    x-apievangelist-error-diagnostic-header: X-Domain-Security-Reason
    x-apievangelist-idempotency: not supported - Domain documents no idempotency key for write operations
- target: $.paths['/v1/listings/{id}'].get
  update:
    x-apievangelist-mcp-tool: listings_get
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/{id}/enquiries'].get
  update:
    x-apievangelist-mcp-tool: listings_get_enquiries
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/{id}/statistics'].get
  update:
    x-apievangelist-mcp-tool: listings_get_listing_statistics
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/business'].put
  update:
    x-apievangelist-mcp-tool: listings_upsert_business_listing
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/business/_search'].post
  update:
    x-apievangelist-mcp-tool: listings_detailed_business_search
    x-apievangelist-read-only: false
- target: $.paths['/v2/listings/business/offmarket'].post
  update:
    x-apievangelist-mcp-tool: listings_upsertbusinessoffmarket
    x-apievangelist-read-only: false
- target: $.paths['/v2/listings/commercial'].put
  update:
    x-apievangelist-mcp-tool: listings_upsertcommerciallisting
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/commercial/_search'].post
  update:
    x-apievangelist-mcp-tool: listings_detailed_commercial_search
    x-apievangelist-read-only: false
- target: $.paths['/v2/listings/commercial/offmarket'].post
  update:
    x-apievangelist-mcp-tool: listings_upsertcommercialoffmarket
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/locations'].get
  update:
    x-apievangelist-mcp-tool: listing_locations_search
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/processingReports'].get
  update:
    x-apievangelist-mcp-tool: listings_get_listing_report_by_reference
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/processingReports/{id}'].get
  update:
    x-apievangelist-mcp-tool: listings_get_listing_report
    x-apievangelist-read-only: true
- target: $.paths['/v1/listings/residential'].put
  update:
    x-apievangelist-mcp-tool: listings_upsert_residential_listing
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/residential/_search'].post
  update:
    x-apievangelist-mcp-tool: listings_detailed_residential_search
    x-apievangelist-read-only: false
- target: $.paths['/v2/listings/residential/offmarket'].post
  update:
    x-apievangelist-mcp-tool: listings_upsertresidentialoffmarket
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/{id}/offmarket'].post
  update:
    x-apievangelist-mcp-tool: listings_update_offmarket_details
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/commercial'].put
  update:
    x-apievangelist-mcp-tool: listings_upsert_commercial_listing
    x-apievangelist-read-only: false
- target: $.paths['/v1/listings/statistics'].get
  update:
    x-apievangelist-mcp-tool: listings_get_listing_statistics_by_agent_id
    x-apievangelist-read-only: true
- target: $.paths['/v2/listings'].get
  update:
    x-apievangelist-mcp-tool: listings_get_v2
    x-apievangelist-read-only: true