DeveloperHub · OpenAPI Overlay 1.0.0

API Evangelist enhancements — DeveloperHub.io Documentation Pages API

8 actions 8 updates update extends developerhub-pages-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-rate-limitx-apis-io-sourcex-apis-io-harvestedexternalDocs

Targets 8

$.info

$.paths['/page'].get

$.paths['/page/{id}'].get

$.paths['/page/{id}'].put

$.paths['/page/{id}'].delete

$.paths['/documentation/{id}/page'].post

$.paths['/page/{id}/publish'].put

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements — DeveloperHub.io Documentation Pages API
  version: 1.0.0
extends: developerhub-pages-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['/page'].get
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 60
      window: 1 minute
      scope: api-key
      source: operation description
- target: $.paths['/page/{id}'].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['/page/{id}'].put
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 10800
      window: 1 hour
      scope: api-key
      source: operation description
- target: $.paths['/page/{id}'].delete
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 10800
      window: 1 hour
      scope: api-key
      source: operation description
- target: $.paths['/documentation/{id}/page'].post
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 10800
      window: 1 hour
      scope: api-key
      source: operation description
- target: $.paths['/page/{id}/publish'].put
  description: Lift the rate limit stated in the operation description into a machine-readable extension.
  update:
    x-rate-limit:
      requests: 10800
      window: 1 hour
      scope: api-key
      source: operation description