Podium · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Podium Reviews

4 actions 4 updates security extends openapi/podium-reviews-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Podium's API. It is a proposal applied on top of the contract, not a document Podium publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-domainx-apievangelist-docsx-apievangelist-harvested-fromsecurityx-apievangelist-notesecuritySchemesx-apievangelist-errors

Targets 3

$.info
$
$.components

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for Podium Reviews
  version: 1.0.0
extends: openapi/podium-reviews-openapi.yml
x-generated: '2026-08-14'
x-method: generated
x-source: apis.yml + repo artifacts (docs-sourced facts the published spec omits)
actions:
- target: $.info
  update:
    x-apievangelist-provider: podium
    x-apievangelist-domain: Reviews
    x-apievangelist-docs: https://docs.podium.com/reference/introduction
    x-apievangelist-harvested-from: https://docs.podium.com (ReadMe API registry)
- target: $
  update:
    security:
    - podiumOAuth2: []
    x-apievangelist-note: The published definition declares no securitySchemes; the scheme below is transcribed
      from https://docs.podium.com/docs/oauth and is an API Evangelist enhancement, not part of Podium's published
      spec.
- target: $.components
  update:
    securitySchemes:
      podiumOAuth2:
        type: oauth2
        description: Podium OAuth 2.0 authorization code flow. Access tokens are valid for 10 hours.
        flows:
          authorizationCode:
            authorizationUrl: https://api.podium.com/oauth/authorize
            tokenUrl: https://api.podium.com/oauth/token
            refreshUrl: https://api.podium.com/oauth/token
            scopes:
              read_reviews: Grant access to all review data for the user's locations.
              write_reviews: Grant access to create reviews data for all the user's locations.
- target: $.info
  update:
    x-apievangelist-errors: errors/podium-problem-types.yml
    x-apievangelist-conventions: conventions/podium-conventions.yml
    x-apievangelist-scopes: scopes/podium-scopes.yml
    x-apievangelist-rate-limit: 300 requests per minute on most routes