Tenable · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for MSSP Portal Resource Links API

4 actions 4 updates phrasing extends openapi/tenable-resource-links-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 4

$.info

$.paths['/mssp/resourcelink/addBulk'].post

$.paths['/mssp/resourcelink/account/{account_uuid}'].get

$.paths['/mssp/resourcelink/account/{account_uuid}'].post

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 MSSP Portal Resource Links API
  version: 1.0.0
extends: openapi/tenable-resource-links-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: 3
- target: $.paths['/mssp/resourcelink/addBulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Add resource links to many customer accounts
      effect: write
      questions:
      - How do I push the same resource links to several customer accounts at once?
      - Can I bulk update resource links across child containers?
      instructions:
      - text: Add resource links {resource_links} to containers {container_uuid_list}.
        slots:
          resource_links: requestBody.resource_links
          container_uuid_list: requestBody.container_uuid_list
      - text: Bulk set links {resource_links} on containers {container_uuid_list} under parent {parent_container_uuid}.
        slots:
          resource_links: requestBody.resource_links
          container_uuid_list: requestBody.container_uuid_list
          parent_container_uuid: requestBody.parent_container_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/resourcelink/account/{account_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer account's resource links
      effect: read
      questions:
      - Which resource links are configured for a given customer account?
      - What links does one MSSP account show its users?
      instructions:
      - text: List the resource links for account {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      - text: Show the configured resource links of customer {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/resourcelink/account/{account_uuid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add resource links to one customer account
      effect: write
      questions:
      - How do I add or change resource links on a single customer account?
      - Can I update one account's links without touching the others?
      instructions:
      - text: Add resource links to customer account {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      - text: Update the resource links on just account {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      method: generated
      generated: '2026-10-01'