Decisiv · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Decisiv Service Management

5 actions 5 updates update extends openapi/decisiv-service-management-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-providerx-apievangelist-profilex-apievangelist-harvestedx-apievangelist-sourcex-apievangelist-artifactsx-error-envelopex-error-code-registryx-rate-limit-headers

Targets 3

$.info

$.components.securitySchemes.OAuth2Password

$.components.securitySchemes.OAuth2AuthorizationCode

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Decisiv Service Management
  version: 1.0.0
extends: openapi/decisiv-service-management-openapi.yml
actions:
- target: $.info
  description: Annotate with API Evangelist profile provenance and the artifacts derived from this spec.
  update:
    x-apievangelist-provider: decisiv
    x-apievangelist-profile: https://apis.io/provider/decisiv/
    x-apievangelist-harvested: '2026-08-12'
    x-apievangelist-source: https://srm-api.decisivapps.com/api-docs/v1
    x-apievangelist-artifacts:
      authentication: authentication/decisiv-authentication.yml
      scopes: scopes/decisiv-scopes.yml
      conventions: conventions/decisiv-conventions.yml
      errors: errors/decisiv-error-codes.yml
      problem-types: errors/decisiv-problem-types.yml
      lifecycle: lifecycle/decisiv-lifecycle.yml
      rate-limits: rate-limits/decisiv-rate-limits.yml
      data-model: data-model/decisiv-data-model.yml
      conformance: conformance/decisiv-conformance.yml
- target: $.info
  description: Record the runtime semantics an agent needs that are true of this API but not expressible in the
    spec itself.
  update:
    x-error-envelope: json-api-errors
    x-error-code-registry: errors/decisiv-error-codes.yml
    x-rate-limit-headers: []
    x-rate-limit-documented: false
- target: $.components.securitySchemes.OAuth2Password
  description: Flag the deprecated password grant explicitly so tooling can refuse to select it.
  update:
    x-deprecated: true
    x-replacement: OAuth2AuthorizationCode
- target: $.components.securitySchemes.OAuth2AuthorizationCode
  description: Attach the scope vocabulary published by the Decisiv authorization server, which the spec leaves
    empty.
  update:
    x-scopes-source: https://login.decisiv.net/.well-known/openid-configuration
    x-scopes-supported:
    - public
    - read
    - write
    - update
    - openid
    x-pkce:
    - S256
    - plain
- target: $.info
  description: Surface the single idempotent operation at document level so it is discoverable without scanning
    139 operations.
  update:
    x-idempotency:
      request_header: X-DECISIV-IDEMPOTENCY-KEY
      response_header: X-Decisiv-Idempotent-Replay
      max_key_length: 128
      operations:
      - POST /service_management/{srm_account_id}/v1/customer_assets/{id}/create_case