Tenable · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for MSSP Portal Child Containers API

4 actions 4 updates phrasing extends openapi/tenable-child-containers-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/accounts/mssp-child-keys'].post

$.paths['/mssp/accounts/childContainers/{user_uuid}'].get

$.paths['/mssp/accounts/childContainers/{account_uuid}/history'].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 MSSP Portal Child Containers API
  version: 1.0.0
extends: openapi/tenable-child-containers-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/accounts/mssp-child-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate API keys for a child container
      effect: write
      questions:
      - How do I get an access key and secret key for a customer's child container?
      - Can I make child container API keys expire after a set time?
      instructions:
      - text: Generate API keys for child container {child_container_uuid}.
        slots:
          child_container_uuid: requestBody.child_container_uuid
      - text: Create keys for child container {child_container_uuid} valid for {seconds} seconds.
        slots:
          child_container_uuid: requestBody.child_container_uuid
          seconds: requestBody.keys_validity_duration_seconds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/accounts/childContainers/{user_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's child containers
      effect: read
      questions:
      - Which MSSP child containers can a given user access?
      - What customer containers are associated with one user?
      instructions:
      - text: List the child containers for user {user_uuid}.
        slots:
          user_uuid: path.user_uuid
      - text: Show which customer containers user {user_uuid} is tied to.
        slots:
          user_uuid: path.user_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/accounts/childContainers/{account_uuid}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: Get child container history for an account
      effect: read
      questions:
      - What changes have happened to the child containers under a parent account?
      - Can I see the history of customer containers for one MSSP account?
      instructions:
      - text: Show child container history for parent account {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      - text: Get the container history of account {account_uuid}.
        slots:
          account_uuid: path.account_uuid
      method: generated
      generated: '2026-10-01'