Brandcast · OpenAPI Overlay 1.0.0

API Evangelist enhancements — Brandcast Templates API

4 actions 4 updates update extends openapi/brandcast-templates-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Brandcast's API. It is a proposal applied on top of the contract, not a document Brandcast publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apis-iox-contract-last-modifiedx-artifactsx-idempotent-retry

Targets 2

$.info
$.paths.*.*

OpenAPI Overlay

Raw ↑
# generated: '2026-08-13'
# method: generated
# source: openapi/brandcast-templates-openapi.yml
overlay: 1.0.0
info:
  title: "API Evangelist enhancements \u2014 Brandcast Templates API"
  version: 1.0.0
extends: openapi/brandcast-templates-openapi.yml
actions:
- target: $.info
  description: Record where the contract actually came from and how it was obtained, so a consumer can
    re-verify it.
  update:
    x-apis-io:
      source-format: Swagger 1.2
      source-url: https://s3.amazonaws.com/apidoc.brandcast-prod.io/templates.json
      discovered-via: https://developer.brandcast.io/ (Swagger UI discoveryUrl)
      converted-by: api-evangelist enrichment pipeline
      converted-on: '2026-08-13'
- target: $.info
  description: Flag contract freshness. The Brandcast API declarations have not changed since 2021-07-01
    (S3 Last-Modified).
  update:
    x-contract-last-modified: '2021-07-01'
- target: $.info
  description: Link the derived artifacts a consumer needs and the contract does not carry.
  update:
    x-artifacts:
      authentication: authentication/brandcast-authentication.yml
      conventions: conventions/brandcast-conventions.yml
      errors: errors/brandcast-problem-types.yml
      lifecycle: lifecycle/brandcast-lifecycle.yml
      data-model: data-model/brandcast-data-model.yml
      skills: skills/_index.yml
- target: $.paths.*.*
  description: Record that no operation in this contract declares an idempotency key, so unsafe methods
    are not blind-retryable.
  update:
    x-idempotent-retry: false