Fine-Tuning Your Spec

Firestone automates the basics, but supports advanced OpenAPI features through pass-through mechanisms and smart defaults.

Key Capabilities

• Custom Response Codes: Document 409 Conflict, 201 Created, etc.
• OpenAPI Extensions: Add x- fields for gateways and tooling.
• Schema Reuse: Use $ref for modular data models.

Schema Composition

Firestone supports oneOf, anyOf, and allOf directly in your schema.items definition.

schema:
  items:
    oneOf:
      - $ref: '#/components/schemas/Dog'
      - $ref: '#/components/schemas/Cat'

Webhooks

While Firestone doesn't have a top-level webhooks DSL yet, you can define webhook payload schemas in your resource and reference them in a manually merged OpenAPI file or via post-processing.