Magic Hour · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Magic Hour audio projects API

3 actions 3 updates update extends openapi/magichour-audio-projects-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Magic Hour's API. It is a proposal applied on top of the contract, not a document Magic Hour publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

contactexternalDocsx-error-envelopex-async-pattern

Targets 2

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Magic Hour audio projects API
  version: 1.0.0
extends: openapi/magichour-audio-projects-api-openapi.yml
x-provenance:
  generated: '2026-09-03'
  method: generated
  source: Derived from Magic Hour docs (support contact, webhook and error references); applies non-destructively
    over the refined spec.
actions:
- target: $.info
  update:
    contact:
      name: Magic Hour Support
      email: support@magichour.ai
      url: https://discord.gg/JX5rgsZaJp
  description: Add the support contact published in the docs (support@magichour.ai; Discord community).
- target: $
  update:
    externalDocs:
      description: Magic Hour API documentation
      url: https://docs.magichour.ai
  description: Point at the developer documentation host.
- target: $.info
  update:
    x-error-envelope: 'All 4xx responses return {"message": string} application/json; see errors/magichour-problem-types.yml'
    x-async-pattern: Creates return {id, credits_charged} immediately; poll the matching *-projects/{id} operation
      or subscribe to signed webhooks (asyncapi/magichour-webhooks.yml).
  description: Record cross-cutting semantics captured during enrichment.