Templafy · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Templafy Public API

3 actions 3 updates update extends openapi/templafy-public-api-v3-openapi.json

Authorship not recorded No authorship marker is recorded for this file. It is not presented as the provider's.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-enrichedx-apievangelist-notesx-apievangelist-authx-apievangelist-error-formatx-apievangelist-paginationx-apievangelist-note

Targets 2

$.info

$.servers[0]

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Templafy Public API
  version: 1.0.0
extends: openapi/templafy-public-api-v3-openapi.json
actions:
- target: $.info
  update:
    x-apievangelist-enriched: '2026-07-21'
    x-apievangelist-notes: >-
      The published v3 spec omits operationIds and tags on every operation, which weakens
      code-generation, MCP tool naming, and agent grounding. Adding stable operationIds and
      resource tags (spaces, libraries, folders, assets, data-sources) is the single highest-value
      spec improvement to file with Templafy.
- target: $.info
  update:
    x-apievangelist-auth: API key sent as HTTP bearer token; per-key scopes set in Admin Center.
    x-apievangelist-error-format: RFC 7807 / 9457 Problem Details (type/title/status/detail/instance/traceId)
    x-apievangelist-pagination: page-number (pageNumber, pageSize)
- target: $.servers[0]
  update:
    x-apievangelist-note: Base URL is per-tenant — https://{tenantId}.api.templafy.com/v3