API Evangelist enhancements for Autopay Accounting Fleet API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Autopay Accounting Fleet API
  version: 1.0.0
extends: ../openapi/autopay-fleet-api-openapi.yml
x-generated: '2026-09-06'
x-method: generated
x-source: openapi/autopay-fleet-api-openapi.yml + https://developer.autopay.io/fleet-api/
x-note: 'Non-destructive record of what API Evangelist added on top of the harvested contract: stable
  operationIds (Autopay declares none), the documented 4xx/5xx responses (the contract carries only 200),
  and the cross-cutting semantics published as prose. The underlying OpenAPI is never mutated.'
actions:
- target: $.info
  description: Link the operation surface back to the provider reference page it was read from.
  update:
    x-api-evangelist-source: https://developer.autopay.io/fleet-api/
    x-api-evangelist-note: Autopay publishes no OpenAPI. This document is API Evangelist’s reading of
      the HTML reference at the URL above.
- target: $
  description: Declare the runtime semantics Autopay documents in prose but does not express in the contract.
  update:
    x-error-envelope:
      shape: '{ "error_id": string, "message": string, "description"?: string }'
      rfc9457: false
      catalog: errors/autopay-problem-types.yml
    x-idempotency:
      coverage: none
      note: Autopay publishes no idempotency key on any write operation.
    x-rate-limit-headers: []
    x-conventions: conventions/autopay-conventions.yml
    x-lifecycle: lifecycle/autopay-lifecycle.yml
- target: $.paths['/fleet/v2/vehicles'].get
  description: Add a stable operationId and the reference URL for GET /fleet/v2/vehicles.
  update:
    operationId: get_v2_vehicles
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles'].get.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/vehicles'].post
  description: Add a stable operationId and the reference URL for POST /fleet/v2/vehicles.
  update:
    operationId: post_v2_vehicles
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles'].post.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/vehicles'].delete
  description: Add a stable operationId and the reference URL for DELETE /fleet/v2/vehicles.
  update:
    operationId: delete_v2_vehicles
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles'].delete.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/vehicles/detach'].post
  description: Add a stable operationId and the reference URL for POST /fleet/v2/vehicles/detach.
  update:
    operationId: post_v2_vehicles_detach
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles/detach'].post.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/services'].get
  description: Add a stable operationId and the reference URL for GET /fleet/v2/services.
  update:
    operationId: get_v2_services
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/services'].get.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/services/by_updated_at'].get
  description: Add a stable operationId and the reference URL for GET /fleet/v2/services/by_updated_at.
  update:
    operationId: get_v2_services_by_updated_at
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/services/by_updated_at'].get.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/vehicles/services'].get
  description: Add a stable operationId and the reference URL for GET /fleet/v2/vehicles/services.
  update:
    operationId: get_v2_vehicles_services
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles/services'].get.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.
- target: $.paths['/fleet/v2/vehicles/disable_payments'].post
  description: Add a stable operationId and the reference URL for POST /fleet/v2/vehicles/disable_payments.
  update:
    operationId: post_v2_vehicles_disable_payments
    x-docs: https://developer.autopay.io/fleet-api/
- target: $.paths['/fleet/v2/vehicles/disable_payments'].post.responses
  description: Record the documented error responses, which the harvested contract does not carry.
  update:
    '400':
      description: Bad request. Body is the Autopay error envelope; branch on error_id. See errors/autopay-problem-types.yml.
    '401':
      description: No access token present in header, or the token is invalid. error_id authentication_error.
    '403':
      description: Token lacks the scope or operator context for this API. error_id forbidden.
    '500':
      description: error_id internal_server_error.