Publer · OpenAPI Overlay 1.0.0

API Evangelist enhancements — Publer Media API

6 actions 6 updates documentation extends openapi/publer-media-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Publer's API. It is a proposal applied on top of the contract, not a document Publer publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

operationIdsecurityBearerApiAuthtermsOfServicecontact

Targets 6

$.paths['/media'].get
$.paths['/media'].post
$.paths['/media/from-url'].post
$
$.components.securitySchemes
$.info

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements — Publer Media API
  version: 1.0.0
extends: openapi/publer-media-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: Enhancements applied on top of the OpenAPI 3.1.1 blocks harvested verbatim from https://publer.com/docs
  into openapi/_original/publer-openapi.yml. This overlay records exactly what API Evangelist added; the
  provider document is never mutated.
actions:
- target: $.paths['/media'].get
  description: Add operationId 'listMedia' — Publer's published OpenAPI block omits operationId on this
    operation, so generated clients, MCP tool bindings and Agent Skills have nothing stable to reference.
  update:
    operationId: listMedia
- target: $.paths['/media'].post
  description: Add operationId 'uploadAMediaFileDirectly' — Publer's published OpenAPI block omits operationId
    on this operation, so generated clients, MCP tool bindings and Agent Skills have nothing stable to
    reference.
  update:
    operationId: uploadAMediaFileDirectly
- target: $.paths['/media/from-url'].post
  description: Add operationId 'uploadMediaFromURL' — Publer's published OpenAPI block omits operationId
    on this operation, so generated clients, MCP tool bindings and Agent Skills have nothing stable to
    reference.
  update:
    operationId: uploadMediaFromURL
- target: $
  description: Declare a document-level security requirement. Publer's per-page OpenAPI blocks declare
    securitySchemes but several omit the document-level `security` array, so the API key requirement is
    not machine-enforced.
  update:
    security:
    - BearerApiAuth: []
- target: $.components.securitySchemes
  description: Normalize the security scheme name to BearerApiAuth. Publer's Analytics and Competitors
    blocks reference a scheme named 'Bearer' that they never define (components.securitySchemes is empty
    in those blocks), leaving a dangling security reference.
  update:
    BearerApiAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key authentication. Format: "Bearer-API YOUR_API_KEY"'
- target: $.info
  description: Add contact email and termsOfService, and expand the description with the auth model and
    Business/Enterprise entitlement, from https://publer.com/docs/api-reference/introduction.md.
  update:
    termsOfService: https://publer.com/terms
    contact:
      name: Publer Support
      email: support@publer.com
      url: https://publer.com/docs