API Evangelist enhancements for the OpenTestData API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the OpenTestData API
  version: 1.0.0
extends: ../openapi/test-ai-opentestdata-openapi.yaml
x-generated: '2026-08-30'
x-method: generated
x-source: openapi/test-ai-opentestdata-openapi.yaml
x-note: >-
  Captures API Evangelist's enhancements without mutating the harvested contract. These actions add
  the servers block, contact and licence the provider's spec omits, and annotate the operations
  whose consequences an agent needs flagged. Every value here is sourced from the provider's own
  repository (README, LICENSE, operation summaries) or from a probe recorded in this repo — nothing
  is invented.
actions:
- target: $.info
  update:
    description: >-
      REST API behind opentestdata.org, test.ai's free and open database of automated test fixture
      data. RETIRED: the canonical hosted instance the provider documented, api.opentestdata.org,
      no longer resolves.
    contact:
      name: test.ai
      url: https://github.com/testdotai/opentestdata-api
    license:
      name: MIT
      url: https://github.com/testdotai/opentestdata-api/blob/master/LICENSE
- target: $
  update:
    servers:
    - url: http://api.opentestdata.org
      description: >-
        The canonical public instance named in the provider's README. Probed 2026-08-30: NXDOMAIN.
        Retained because it is what the provider published, not because it is reachable.
    - url: http://localhost:5000
      description: Local development server (`make serve`), per the provider's README.
- target: $.paths['/users/{id}/promote'].post
  update:
    x-consequence: irreversible
    x-agent-note: >-
      Grants admin privileges. No demote or revoke counterpart exists anywhere in this contract,
      so the escalation cannot be undone through the API.
- target: $.paths['/data/{id}'].post
  update:
    x-agent-note: >-
      A POST that updates in place. It is not idempotent and no prior revision is retrievable, so
      a retry overwrites rather than reconciles.
- target: $.paths['/users/{id}/avatar'].get
  update:
    x-agent-note: >-
      The provider's own summary states this operation is available only in the development
      version of the server, so it should not be expected on any deployed instance.