RTB House · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Client's panel API docs Advertisers API

14 actions 14 updates update extends openapi/rtbhouse-advertisers-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for RTB House's API. It is a proposal applied on top of the contract, not a document RTB House publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-gapsx-apievangelist-providerx-apievangelist-artifactsx-api-version-headerx-retired-version-statusx-error-envelopex-rate-limitx-idempotency

Targets 13

$.info
$.paths['/advertisers'].get
$.paths['/advertisers/{hash}'].get
$.paths['/advertisers/{hash}/status'].put
$.paths['/advertisers/{hash}/client'].get
$.paths['/advertisers/{hash}/offer-categories'].get
$.paths['/advertisers/{hash}/offers'].get
$.paths['/advertisers/{hash}/campaigns'].get
$.paths['/advertisers/{hash}/campaigns/{campaignHash}/status'].put
$.paths['/advertisers/{hash}/billing'].get
$.paths['/advertisers/{hash}/rtb-creatives'].get
$.paths['/advertisers/{hash}/conversions'].get
$.paths['/advertisers/{hash}/rate-cards'].get

OpenAPI Overlay

Raw ↑
overlay: 1.0.0
info:
  title: API Evangelist enhancements for Client's panel API docs Advertisers API
  version: 1.0.0
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/rtbhouse-advertisers-api-openapi.yml
extends: openapi/rtbhouse-advertisers-api-openapi.yml
actions:
- target: $.info
  description: Record the API Evangelist enrichment context for this contract.
  update:
    x-apievangelist-provider: rtbhouse
    x-apievangelist-artifacts:
      authentication: authentication/rtbhouse-authentication.yml
      conventions: conventions/rtbhouse-conventions.yml
      errors: errors/rtbhouse-problem-types.yml
      rate-limits: rate-limits/rtbhouse-rate-limits.yml
      lifecycle: lifecycle/rtbhouse-lifecycle.yml
      data-model: data-model/rtbhouse-data-model.yml
- target: $.info
  description: 'Document the runtime semantics the published contract omits: versioning header, error
    envelope, and the resource-usage rate-limit signal.'
  update:
    x-api-version-header: X-Current-Api-Version
    x-retired-version-status: 410
    x-error-envelope:
      status: error
      fields:
      - status
      - message
      - httpCode
      - appCode
      - errors
      rfc9457: false
    x-rate-limit:
      status: 429
      header: X-Resource-Usage
      format: METRIC-WINDOWSECONDS=used/limit joined by ";"
      metrics:
      - WORKER_TIME
      - BQ_TB_BILLED
      retry_after: false
    x-idempotency:
      supported: false
- target: $.paths['/advertisers'].get
  description: Flag the contract gaps on GET /advertisers — no operationId and no documented 4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}'].get
  description: Flag the contract gaps on GET /advertisers/{hash} — no operationId and no documented 4xx/5xx
    response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/status'].put
  description: Flag the contract gaps on PUT /advertisers/{hash}/status — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/client'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/client — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/offer-categories'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/offer-categories — no operationId and
    no documented 4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/offers'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/offers — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/campaigns'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/campaigns — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/campaigns/{campaignHash}/status'].put
  description: Flag the contract gaps on PUT /advertisers/{hash}/campaigns/{campaignHash}/status — no
    operationId and no documented 4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/billing'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/billing — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/rtb-creatives'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/rtb-creatives — no operationId and no
    documented 4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/conversions'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/conversions — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses
- target: $.paths['/advertisers/{hash}/rate-cards'].get
  description: Flag the contract gaps on GET /advertisers/{hash}/rate-cards — no operationId and no documented
    4xx/5xx response.
  update:
    x-apievangelist-gaps:
    - no-operationId
    - no-error-responses