API Evangelist enhancements for Audience Segments API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Audience Segments API
  version: 1.0.0
extends: ./../openapi/mediamath-audience-segments-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/mediamath-audience-segments-api-openapi.yml
actions:
- target: $.info
  description: Record API Evangelist provenance and the enrichment pass that captured this contract.
  update:
    x-apievangelist:
      provider: mediamath
      aid: mediamath
      enriched: '2026-08-13'
      captured_from: https://apidocs.mediamath.com/mcp (get-full-api-description)
      artifacts:
      - conventions/mediamath-conventions.yml
      - errors/mediamath-problem-types.yml
      - lifecycle/mediamath-lifecycle.yml
      - authentication/mediamath-authentication.yml
      - rate-limits/mediamath-rate-limits.yml
      - data-model/mediamath-data-model.yml
- target: $.info
  description: Attach the documented cross-cutting runtime semantics that the raw contract does not state.
  update:
    x-conventions:
      idempotency:
        supported: false
        note: No Idempotency-Key header or client-supplied request key is documented anywhere in the MediaMath
          developer documentation. Read back before retrying a create.
      error_envelope: '{"meta":{"status":"error","uuid":"..."},"errors":[{"code":"...","message":"...","details":{}}]}'
      rate_limit_headers:
      - X-RateLimit-Limit
      - X-RateLimit-Remaining
      - X-RateLimit-Reset
      - X-Concurrency-Limit
      - X-Concurrency-Remaining
      - Retry-After
      rate_limit_note: Header values are per-pod (5 production pods); documented safe sustained rate is
        40 req/s cluster-wide.
      pagination:
        style: offset
        params:
        - page_limit
        - page_offset
        - sort_by
        - q
      update_method: POST (not PUT/PATCH)
      bulk_partial_success: HTTP 207 Multi-Status
- target: $.info
  description: Record the token endpoint and the legacy dual-auth requirement the specs do not express.
  update:
    x-authentication:
      token_endpoint: https://auth.mediamath.com/oauth/token
      authorize_endpoint: https://auth.mediamath.com/authorize
      audience: https://api.mediamath.com/
      token_lifetime_seconds: 86400
      provider: Auth0
      legacy_session_cookie: Some APIs are not fully migrated to OAuth2. GET https://api.mediamath.com/api/v2.0/session
        with the bearer token and send the returned adama_session cookie alongside the Authorization header.
- target: $.info
  description: Surface the deprecation notice the provider publishes only in documentation prose.
  update:
    x-lifecycle:
      deprecated_as_of: '2026-08-01'
      replacement: https://apidocs.mediamath.com/apis/campaigns-api/openapi
      statement: This API is deprecated as of 1st August 2026. The functionality has been built into the
        V3 Campaign Management API.
      note: 'The provider announces this deprecation only as prose on the API documentation page. No operation
        in the contract carries deprecated: true and no Sunset or Deprecation response header is documented.
        This overlay surfaces the notice on the contract itself without mutating the original.'
      source: https://apidocs.mediamath.com/apis/audience-taxonomies