Cover Whale API V1 -- API Evangelist enrichment overlay

overlay: 1.0.0
info:
  title: Cover Whale API V1 -- API Evangelist enrichment overlay
  version: 1.0.0
  x-provenance:
    generated: '2026-11-04'
    method: derived
    source:
    - https://docs.coverwhale.com/introduction.md
    - https://docs.coverwhale.com/base-url.md
    - https://docs.coverwhale.com/authentication.md
    - https://docs.coverwhale.com/guides/quoting.md
    - https://docs.coverwhale.com/guides/submissions.md
    - https://docs.coverwhale.com/guides/policy-lifecycle.md
    - https://docs.coverwhale.com/guides/endorsements.md
    - https://docs.coverwhale.com/webhooks.md
    note: Overlay applied on top of openapi/coverwhaleinsurancesolutions-openapi.json (Cover Whale API V1, 43 operations). All additions are faithful
      derivations from Cover Whale's own Mintlify docs (markdown-twin pages). The upstream spec declares only the test server, only the `Authentication`
      tag, no support email, no description, and no external documentation link -- this overlay restores facts the docs already state.
extends: ../openapi/_original/coverwhaleinsurancesolutions-openapi.json
actions:
- target: $.info
  update:
    description: 'REST API for Cover Whale''s commercial auto insurance platform. The API covers authentication, quoting (DOT pre-screen, indication,
      quote, coverage guidelines), submission data (vehicles, drivers, trailers, documents, taxes and fees), binding, policy lifecycle (endorsements,
      cancellations, reinstatements, non-renewals, declines), reference data, and webhook subscriptions. Access is credentialled -- request a
      username/password from api-support@coverwhale.com. Authentication uses a custom `AccessToken` header (not `Authorization: Bearer`); tokens
      are issued by POST /authentication and expire after 1 hour.'
- target: $.info.contact
  update:
    email: api-support@coverwhale.com
    url: https://docs.coverwhale.com/introduction
- target: $.servers
  update:
  - url: https://api.coverwhale.com/v1
    description: Production -- live policies, real premiums, real binds.
  - url: https://api.coverwhale.dev/v1
    description: Test -- development and integration testing; safe to experiment, no real policies created.
- target: $.externalDocs
  update:
    description: Cover Whale API documentation
    url: https://docs.coverwhale.com/introduction
- target: $.tags
  update:
  - name: Authentication
    description: Health check and credential-based token exchange (AccessToken + RefreshToken).
  - name: Quoting
    description: DOT pre-screen, coverage guidelines, indications (preliminary pricing), and full quotes (binding-eligible pricing) across Auto
      Liability, Auto Physical Damage, Motor Truck Cargo, Truckers General Liability, and Non-Trucking Liability.
  - name: Reference Data
    description: Enumerations and lookup lists -- commodities, coverage guidelines.
  - name: Submissions
    description: Submission status, transaction history, and public-reply notes (inbound counterpart to the submission.public_reply webhook).
  - name: Submission Data
    description: Update a submission transaction -- vehicles, drivers, trailers, documents, taxes/fees, and premium recalculation.
  - name: Binding
    description: Submit a bind request for a quoted submission.
  - name: Policy Lifecycle
    description: Endorsements, cancellation (request / approve / execute), reinstatement, non-renewal, and decline.
  - name: Webhooks
    description: Register, list, update, rotate the signing secret, and delete HTTPS endpoints for submission-event delivery.