FileType Converters API enhancements

overlay: 1.0.0
info:
  title: FileType Converters API enhancements
  version: 1.0.0
  description: >
    Enhancements to the provider's OpenAPI 3.1 document at
    https://filetypeconverters.com/api/v1/openapi.json. Adds operationId values
    (the source document ships none), a top-level tag, and short agent-oriented
    summaries so tools and skills can bind to named operations.
generated: '2026-11-07'
method: derived
source: openapi/filetypeconverters-com-openapi.json
extends: ../openapi/_original/filetypeconverters-com-openapi.json
x-provenance:
  by: API Evangelist enrichment pipeline
  surfaces_module: overlays
  evidence:
  - url: https://filetypeconverters.com/api/v1/openapi.json
    note: Working copy saved under openapi/; lacks operationIds.
  - url: https://filetypeconverters.com/llms.txt
    note: Anchor for operation naming and auth semantics.
actions:
- target: $.info
  update:
    x-apievangelist-notes: >
      operationIds added below are an enrichment, not published by the provider.
- target: $.paths['/api/v1/convert'].post
  update:
    operationId: convertFile
    summary: Convert a single file (synchronous or queued).
- target: $.paths['/api/v1/pairs'].get
  update:
    operationId: listPairs
    summary: List all supported source->target conversion pairs.
- target: $.paths['/api/v1/formats'].get
  update:
    operationId: listFormats
    summary: List every file format the service reads or writes.
- target: $.paths['/api/v1/jobs/{id}'].get
  update:
    operationId: getJob
    summary: Fetch the status and metadata of an asynchronous conversion job.
- target: $.paths['/api/v1/jobs/{id}/download'].get
  update:
    operationId: downloadJob
    summary: Download the output of a completed conversion job.
- target: $.paths['/api/v1/batches'].post
  update:
    operationId: createBatch
    summary: Submit a batch of conversions.
- target: $.paths['/api/v1/batches/{id}'].get
  update:
    operationId: getBatch
    summary: Fetch the status of a batch submission.
- target: $.paths['/api/v1/batches/{id}/download'].get
  update:
    operationId: downloadBatch
    summary: Download the aggregated output of a completed batch.
- target: $.paths['/api/v1/usage'].get
  update:
    operationId: getUsage
    summary: Report the caller's conversion and AI Deep Read usage.
- target: $.paths['/api/v1/openapi.json'].get
  update:
    operationId: getOpenapi
    summary: Fetch the published OpenAPI 3.1 document.