Tenable · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for PCI ASV Attestations API

6 actions 6 updates phrasing extends openapi/tenable-attestations-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Tenable's API. It is a proposal applied on top of the contract, not a document Tenable publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info

$.paths['/pci-asv/attestations/list'].get

$.paths['/pci-asv/attestations/details/{attestation_uuid}'].get

$.paths['/pci-asv/attestations/details/{attestation_uuid}/disputes'].get

$.paths['/pci-asv/attestations/{attestation_uuid}/failures/undisputed/list'].get

$.paths['/pci-asv/attestations/{attestation_uuid}/assets/list'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for PCI ASV Attestations API
  version: 1.0.0
extends: openapi/tenable-attestations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/pci-asv/attestations/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List PCI ASV attestations
      effect: read
      questions:
      - What PCI ASV attestations do I have and what state are they in?
      - Can I filter my PCI attestations by status?
      instructions:
      - text: List my PCI ASV attestations.
      - text: List PCI attestations with status {status_type}.
        slots:
          status_type: query.status_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/pci-asv/attestations/details/{attestation_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PCI attestation's details
      effect: read
      questions:
      - What are the details of a specific PCI attestation?
      - Do I need special access from support to read PCI attestation details?
      instructions:
      - text: Get the details of PCI attestation {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      - text: Show me the summary for attestation {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/pci-asv/attestations/details/{attestation_uuid}/disputes'].get
  update:
    x-apievangelist-phrasing:
      intent: List disputes on a PCI attestation
      effect: read
      questions:
      - Which failures have been disputed on a PCI attestation?
      - Can I page through the disputes filed for an attestation?
      instructions:
      - text: List the disputes for PCI attestation {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      - text: Show {limit} disputes on attestation {attestation_uuid} sorted by {sort}.
        slots:
          limit: query.limit
          attestation_uuid: path.attestation_uuid
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/pci-asv/attestations/{attestation_uuid}/failures/undisputed/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List undisputed failures on an attestation
      effect: read
      questions:
      - Which PCI scan failures are still undisputed on my attestation?
      - What do I still need to fix or dispute before passing PCI ASV?
      instructions:
      - text: List undisputed failures for attestation {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      - text: Show the open, undisputed PCI failures on {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/pci-asv/attestations/{attestation_uuid}/assets/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List assets covered by an attestation
      effect: read
      questions:
      - Which assets are included in a given PCI attestation?
      - Can I page through the PCI assets attested?
      instructions:
      - text: List the assets in PCI attestation {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      - text: Show the attested PCI assets for {attestation_uuid}.
        slots:
          attestation_uuid: path.attestation_uuid
      method: generated
      generated: '2026-10-01'