overlay: 1.0.0
info:
  title: API Evangelist overlay for Spiris Lon (Cloud Payroll) API V2
  version: 1.0.0
extends: openapi/visma-payroll-api-v2-openapi.json
x-generated: '2026-09-13'
x-method: generated
x-source: API Evangelist enrichment pipeline; captures our annotations without mutating the published
  spec.
actions:
- target: $.info
  description: Add API Evangelist provenance and contact metadata the published spec omits.
  update:
    contact:
      name: Visma API support
      url: https://docs.vismasoftware.no/vismanetapi/support/
    x-api-evangelist-profile: https://apis.io/provider/visma
    x-harvested-from:
      openapi: visma
      source: first-party published specification
      date: '2026-09-13'
- target: $.paths
  description: 'No operation in this document declares an operationId, so no client generator, Arazzo
    workflow or MCP tool crosswalk can address an operation by name. Recorded as a finding rather than
    repaired: inventing operationIds would create identifiers Visma never published.'
  update:
    x-api-evangelist-finding: operationId missing on all 88 operations