Eclipse Foundation · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Eclipse Foundation Mailing List API

4 actions 4 updates documentation extends openapi/eclipse-mailing-lists-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Eclipse Foundation's API. It is a proposal applied on top of the contract, not a document Eclipse Foundation publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

contacttermsOfServicedescriptionx-api-evangelist-note-missing-operation-ids

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Eclipse Foundation Mailing List API
  version: 1.0.0
extends: openapi/eclipse-mailing-lists-api-openapi.yml
x-generated: '2026-09-07'
x-method: generated
x-source: Enhancements over the verbatim specification harvested from https://webdev.eclipse.org/docs/api/eclipsefdn-mailing-lists-api
  on 2026-09-07. Grounded in apis.yml and the Eclipse Foundation's own published legal/contact pages. The original specification
  in openapi/ is never mutated.
actions:
- target: $.info
  description: Add a contact the Eclipse Foundation publishes elsewhere; this specification declares none.
  update:
    contact:
      name: Eclipse Foundation
      url: https://www.eclipse.org/org/foundation/contact.php
      email: webmaster@eclipse.org
- target: $.info
  description: Add the Eclipse.org Terms of Use that govern this API.
  update:
    termsOfService: https://www.eclipse.org/legal/termsofuse.php
- target: $.info
  description: Add a description; the published specification has none.
  update:
    description: Eclipse Foundation Mailing List API — a first-party Eclipse Foundation REST API. Harvested from https://webdev.eclipse.org/docs/api/eclipsefdn-mailing-lists-api
      on 2026-09-07. See https://webdev.eclipse.org/docs/api/ for the full Eclipse Foundation API index.
- target: $.info
  description: 'NOTE ONLY — 6 of 6 operations in this specification declare no operationId, which prevents deterministic
    tool and SDK generation. No operationId is invented here; naming them is the provider''s call. Affected: GET , GET
    /available, GET /{listName}, GET /projects, GET /projects/available, GET /projects/{projectID}'
  update:
    x-api-evangelist-note-missing-operation-ids: 6