openapi: 3.0.1
info:
  title: Unify Integrations
  description: "Public-facing surface exposed via Azure API Management at\n`api.mediavalet.com/integrations`. Endpoints absent from this\ndocument are intentionally not part of the public contract.\n\n**Authentication:** every request must carry a MediaValet IAM JWT\nin the `Authorization: Bearer <token>` header AND a\n`Ocp-Apim-Subscription-Key` issued by APIM.\n\n**Versioning:** APIM injects `x-mv-api-version: 1.2` and\n`X-MV-Via-APIM: true` on every inbound request. Callers do not\nneed to set them. Direct backend traffic without the APIM marker\ncontinues to receive the legacy un-enveloped response.\n\n**Response shape:** every successful response is wrapped in a\ncommon envelope (`apiVersion`, `buildVersion`, `payload`,\n`recordCount`, `meta`). Error responses share the same envelope\nwith `errors[]` and `meta.correlationId` instead of `payload`."
  version: '1.0'
servers:
  - url: https://api.mediavalet.com/integrations
paths: { }
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
security:
  - { }
  - apiKeyHeader: [ ]
  - apiKeyQuery: [ ]