Denim · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Denim Public API

3 actions 3 updates update extends openapi/denim-openapi-original.json

Authorship not recorded No authorship marker is recorded for this file. It is not presented as the provider's.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-enrichedx-apievangelist-providerx-apievangelist-notesx-apievangelist-recommendations

Targets 2

$.info

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Denim Public API
  version: 1.0.0
extends: openapi/denim-openapi-original.json
actions:
  - target: $.info
    update:
      x-apievangelist-enriched: '2026-07-18'
      x-apievangelist-provider: denim
      x-apievangelist-notes: >-
        Denim freight-factoring and back-office API. Enhancements captured as an overlay;
        the original spec is never mutated.
  - target: $.servers
    update:
      - description: Production Environment
        url: https://app.denim.com
      - description: Staging Environment
        url: https://staging.denim.com
    # The published spec lists only staging; production requests go to app.denim.com.
  - target: $.info
    update:
      x-apievangelist-recommendations:
        - Add 4xx/5xx responses (401 unauthorized, 404 not found, 422 validation) with an
          application/problem+json (RFC 9457) envelope.
        - Adopt stable, unique, human-readable operationIds (current ids are auto-generated
          Elixir controller names with spaces and duplicate suffixes).
        - Document rate-limit signaling headers.
        - Publish a first-party SDK and/or CLI.