API Evangelist enrichment overlay — Dev.to Forem Articles API

overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay — Dev.to Forem Articles API
  version: 1.0.0
extends: dev-to-articles-api-openapi.yml
x-generated: '2026-09-17'
x-method: derived
x-source: conventions/, errors/, rate-limits/, lifecycle/ artifacts in this repo
actions:
- target: $.info
  description: Record enrichment provenance and the version-selector header that this contract does not state.
  update:
    x-api-evangelist-enrichment:
      generated: '2026-09-17'
      provider: dev-to
      artifacts:
      - conventions/dev-to-conventions.yml
      - errors/dev-to-problem-types.yml
      - rate-limits/dev-to-rate-limits.yml
      - lifecycle/dev-to-lifecycle.yml
      - authentication/dev-to-authentication.yml
    x-version-selector:
      header: Accept
      value: application/vnd.forem.api-v1+json
      required: true
      note: Omitting this header routes the request to the deprecated V0 API, which answers with a 299 Warning header.
        The version is not in the path.
    x-error-envelope:
      media_type: application/json
      rfc9457: false
      shape: '{"status": <int>, "error": "<message>"}'
- target: $.paths['/articles'].post
  description: Attach the published rate limit for createArticle, which the contract omits.
  update:
    x-rate-limit:
      limit: 10
      window: 30s
      scope: per-api-key
      status_on_exhaustion: 429
      headers_returned: false
      source: https://developers.forem.com/api/v0
- target: $.paths['/articles/{id}'].put
  description: Attach the published rate limit for updateArticle, which the contract omits.
  update:
    x-rate-limit:
      limit: 30
      window: 30s
      scope: per-api-key
      status_on_exhaustion: 429
      headers_returned: false
      source: https://developers.forem.com/api/v0
- target: $.paths['/articles/{id}/unpublish'].put
  description: Record reversibility, which the contract does not express.
  update:
    x-reversibility:
      grade: documented
      window: null
      note: Reverses a publish. No article delete operation exists in this API; no window is published.