Skip to content

openapi2conv: Operation-level externalDocs are not preserved #1069

@hwustrack

Description

@hwustrack

openapi2conv does not preserve externalDocs defined on an operation.

Input

swagger: '2.0'
info:
  version: 1.0.0
  title: title
paths:
  /test:
    get:
      externalDocs:
        url: https://example/operation
        description: Operation level documentation
      responses:
        '200':
          description: description

Expected output

openapi: 3.0.3
info:
  version: 1.0.0
  title: title
paths:
  /test:
    get:
      externalDocs:
        url: https://example/operation
        description: Operation level documentation
      responses:
        '200':
          description: description

Actual output

openapi: 3.0.3
info:
  version: 1.0.0
  title: title
paths:
  /test:
    get:
      responses:
        '200':
          description: description

Additional context

Root-level and schema-level externalDocs fields are preserved correctly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions