API Evangelist overlay for Leonardo.AI REST API v2

overlay: 1.0.0
info:
  title: API Evangelist overlay for Leonardo.AI REST API v2
  version: 1.0.0
extends: openapi/leonardo-ai-v2-api-openapi.yml
x-generated: '2026-10-21'
x-method: generated
x-source: openapi/leonardo-ai-v2-api-openapi.yml
x-rationale: Adds provider documentation links (reference pages, llms.txt, error, rate-limit and webhook guides)
  and agent-surface bindings without mutating the OpenAPI. Per-operation reference links are added only for the
  v2 operations whose reference pages the provider indexes in llms.txt.
actions:
- target: $
  description: Add externalDocs pointing at the provider API reference.
  update:
    externalDocs:
      description: Leonardo.Ai API reference
      url: https://docs.leonardo.ai/reference
- target: $.info
  description: Link the provider llms.txt index and error-message guide.
  update:
    x-llms-txt: https://docs.leonardo.ai/llms.txt
    x-error-guide: https://docs.leonardo.ai/docs/api-error-messages
    x-rate-limit-guide: https://docs.leonardo.ai/docs/guide-to-concurrency-queue-and-rate-limit
- target: $.paths['/generations'].post
  description: Link createGeneration to its provider reference page.
  update:
    externalDocs:
      url: https://docs.leonardo.ai/reference/creategeneration.md
- target: $.paths['/generationssync'].post
  description: Link createSyncGeneration to its provider reference page.
  update:
    externalDocs:
      url: https://docs.leonardo.ai/reference/createsyncgeneration.md
- target: $.paths['/models'].get
  description: Link getModels to its provider reference page.
  update:
    externalDocs:
      url: https://docs.leonardo.ai/reference/getmodels.md
- target: $.paths['/generations'].post
  description: Record async completion (webhook callback or polling) and the MCP tool that fronts this operation.
  update:
    x-async-completion:
      webhook_guide: https://docs.leonardo.ai/docs/guide-to-the-webhook-callback-feature
      webhook_auth: 'authorization: Bearer <webhook callback API key>, configured when creating a production API
        key'
      poll_operation: getGenerationById
    x-mcp-tool:
      server: https://mcp.leonardo.ai/v1/mcp
      tool: generate-image
      confidence: medium