Uncle Nearest · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Uncle Nearest Events Calendar REST API (tribe/events/v1)

5 actions 5 updates update extends openapi/uncle-nearest-events-calendar-v1-openapi.json

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-harvestedx-apievangelist-source-urlx-apievangelist-surfacecontactlicensex-apievangelist-gapsx-apievangelist-error-catalog

Targets 4

$.info

$.components

$.paths['/events'].get

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Uncle Nearest Events Calendar REST API (tribe/events/v1)
  version: 1.0.0
extends: openapi/uncle-nearest-events-calendar-v1-openapi.json
x-generated: '2026-08-02'
x-method: generated
x-source: >-
  Enhancements derived from this repo's artifacts (conventions, errors, data-model, authentication) over the verbatim
  spec harvested from https://unclenearest.com/wp-json/tribe/events/v1/doc on 2026-08-02. The original spec is never
  mutated.
actions:
- target: $.info
  update:
    x-apievangelist-provider: uncle-nearest
    x-apievangelist-harvested: '2026-08-02'
    x-apievangelist-source-url: https://unclenearest.com/wp-json/tribe/events/v1/doc
    x-apievangelist-surface: >-
      Plugin-provided events API served from the brand's own WordPress host. Not a product API and not
      supported as a developer-facing interface by Uncle Nearest.
    contact:
      name: Uncle Nearest
      url: https://unclenearest.com/contact-us/
    license:
      name: No published API terms
      url: https://unclenearest.com/terms-conditions/
- target: $.info
  update:
    x-apievangelist-gaps:
    - no-operationids
    - no-summaries
    - no-security-schemes-declared
    - no-response-examples
    - no-tags
- target: $.components
  update:
    x-apievangelist-error-catalog: errors/uncle-nearest-problem-types.yml
    x-apievangelist-data-model: data-model/uncle-nearest-data-model.yml
- target: $.paths['/events'].get
  update:
    x-apievangelist-conventions:
      pagination:
        style: page-number
        params:
        - page
        - per_page
        response_fields:
        - total
        - total_pages
        - rest_url
        - next_rest_url
        - previous_rest_url
      auth: none-for-published-content
- target: $.servers
  update:
    x-apievangelist-note: >-
      Single server, the brand's own host. Anonymous GETs return published events; write methods require WordPress
      cookie or application-password authentication.