API Evangelist enhancements for the Rainbrand API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Rainbrand API
  version: 1.0.0
extends: ../openapi/_original/rainbrand-api-openapi.json
x-generated: '2026-07-21'
x-method: generated
actions:
  - target: $.info
    description: Add catalog identity, contact and enrichment metadata without touching the harvested spec.
    update:
      description: >-
        Rainbrand is the brand layer for agents: onboard a brand from a website or
        Instagram URL and every image generated through the API comes back
        on-brand. Async job model (202 + wait=true long-poll), cursor
        pagination, credit-based billing, hosted MCP server at
        https://mcp.rainbrand.com/mcp.
      contact:
        name: Rainbrand Support
        email: support@rainbrand.com
        url: https://docs.rainbrand.com
      x-apievangelist:
        provider: rainbrand
        artifacts:
          conventions: conventions/rainbrand-conventions.yml
          errors: errors/rainbrand-problem-types.yml
          authentication: authentication/rainbrand-authentication.yml
          rate-limits: rate-limits/rainbrand-rate-limits.yml
  - target: $
    description: Record external documentation for the whole surface.
    update:
      externalDocs:
        description: Rainbrand API documentation
        url: https://docs.rainbrand.com
  - target: $.paths['/images/generations'].post
    description: Flag the credit cost and readiness precondition on the marquee operation.
    update:
      x-credit-cost: '2K = 1 credit, 4K = 2 credits; variantCount multiplies'
      x-precondition: Brand status must be "ready" or the call returns 409 BRAND_NOT_READY.