API Evangelist enhancements — DeveloperHub.io API References API

overlay: 1.0.0
info:
  title: API Evangelist enhancements — DeveloperHub.io API References API
  version: 1.0.0
extends: developerhub-references-api-openapi.yml
x-generated: '2026-09-06'
x-method: generated
x-source: derived from the operation descriptions in the extended document; no content invented
actions:
- target: $.info
  description: Attach the provider API reference as externalDocs and record the harvest source.
  update:
    x-apis-io-source: https://docs.developerhub.io/api.md
    x-apis-io-harvested: '2026-09-06'
- target: $
  description: Add externalDocs pointing at the provider API reference.
  update:
    externalDocs:
      description: DeveloperHub API reference
      url: https://docs.developerhub.io/api/ref
- target: $.paths['/version/{versionId}/reference'].post
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 300
      window: 60 minutes
      scope: api-key
      source: operation description
- target: $.paths['/reference/{id}/definition'].get
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 600
      window: 1 minute
      scope: api-key
      source: operation description
- target: $.paths['/reference/{id}/publish'].put
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 300
      window: 60 minutes
      scope: api-key
      source: operation description