Datavant · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Datavant REST API

6 actions 6 updates documentation extends openapi/datavant-rest-api-openapi.yml

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-notex-apievangelist-profilex-apievangelist-sourcex-apievangelist-harvestedcontacttermsOfServicedescriptionx-apievangelist-error-catalog

Targets 6

$.info

$.servers

$.components.securitySchemes.oauth2

$.components.schemas.ErrorHTTPResponse

$.components.schemas.Links

$.tags[?(@.name=='Release Notes')]

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Datavant REST API
  version: 1.0.0
extends: openapi/datavant-rest-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-profile: https://apis.io/provider/datavant
    x-apievangelist-source: https://developer.datavant.com/openapi.json
    x-apievangelist-harvested: '2026-08-14'
    x-apievangelist-note: Spec is served on the API-reference host root; developer.datavant.com/ itself
      returns 404.
    contact:
      name: Datavant Support
      email: support@datavant.com
      url: https://developer.datavant.com/docs
    termsOfService: https://www.datavant.com/terms-of-use
- target: $.servers
  update:
  - url: https://api.datavant.io/v2
    description: Production - the only server the specification declares.
- target: $.components.securitySchemes.oauth2
  update:
    description: OAuth 2.0 client credentials. POST client_id/client_secret to https://api.datavant.io/v2/oauth2/token;
      the response carries a bearer access_token valid for 7200 seconds. The scopes map is empty - a token
      grants every operation.
- target: $.components.schemas.ErrorHTTPResponse
  update:
    x-apievangelist-error-catalog: errors/datavant-problem-types.yml
    x-apievangelist-format: vendor-envelope (not RFC 9457 application/problem+json)
- target: $.components.schemas.Links
  update:
    x-apievangelist-pagination: limit/offset, limit default 50 maximum 100; see conventions/datavant-conventions.yml
- target: $.tags[?(@.name=='Release Notes')]
  update:
    x-apievangelist-changelog: changelog/datavant-changelog.yml
    x-apievangelist-note: Newest entry 2023-09-13; info.version still 2023-04-01.