# 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 Logos API
  version: 1.0.0
extends: openapi/tenable-logos-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: 8
- target: $.paths['/mssp/logos'].get
  update:
    x-apievangelist-phrasing:
      intent: List logos in the MSSP Portal
      effect: read
      questions:
      - Which logos have I uploaded to the MSSP Portal?
      - What branding images are available to assign to customer accounts?
      instructions:
      - text: List all logos uploaded to my MSSP Portal.
      - text: Show me the logos available for customer branding.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a new logo
      effect: write
      questions:
      - How do I upload a logo to the MSSP Portal for customer branding?
      - Do I need to name a logo when I upload it?
      instructions:
      - text: Upload logo file {logo} named {name}.
        slots:
          logo: requestBody.logo
          name: requestBody.name
      - text: Add a new portal logo called {name} from {logo}.
        slots:
          name: requestBody.name
          logo: requestBody.logo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos/{logo_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a logo
      effect: read
      questions:
      - What metadata is stored for a specific uploaded logo?
      - Can I look up one logo by its UUID?
      instructions:
      - text: Get the details of logo {logo_uuid}.
        slots:
          logo_uuid: path.logo_uuid
      - text: Show me the name and metadata of logo {logo_uuid}.
        slots:
          logo_uuid: path.logo_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos/{logo_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a logo
      effect: destructive
      questions:
      - Can I remove a logo I no longer use from the portal?
      - Which call deletes an uploaded branding logo?
      instructions:
      - text: Delete logo {logo_uuid}.
        slots:
          logo_uuid: path.logo_uuid
      - text: Remove logo {logo_uuid} from the MSSP Portal.
        slots:
          logo_uuid: path.logo_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos/{logo_uuid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace an existing logo
      effect: write
      questions:
      - Can I swap out the image of a logo I already uploaded?
      - Does updating a logo overwrite the previous file?
      instructions:
      - text: Replace logo {logo_uuid} with file {logo} named {name}.
        slots:
          logo_uuid: path.logo_uuid
          logo: requestBody.logo
          name: requestBody.name
      - text: Overwrite existing logo {logo_uuid} using new image {logo} and name {name}.
        slots:
          logo_uuid: path.logo_uuid
          logo: requestBody.logo
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/accounts/logos'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a logo to customer accounts
      effect: write
      questions:
      - How do I brand several customer accounts with the same logo?
      - Can one logo be applied to multiple child accounts at once?
      instructions:
      - text: Assign logo {logo_uuid} to accounts {account_uuids}.
        slots:
          logo_uuid: requestBody.logo_uuid
          account_uuids: requestBody.account_uuids
      - text: Brand customer accounts {account_uuids} with logo {logo_uuid}.
        slots:
          account_uuids: requestBody.account_uuids
          logo_uuid: requestBody.logo_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos/{logo_uuid}/logo.png'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a logo as PNG
      effect: read
      questions:
      - Can I download an uploaded logo as a PNG image?
      - Where do I get the image file for a portal logo?
      instructions:
      - text: Download logo {logo_uuid} as PNG.
        slots:
          logo_uuid: path.logo_uuid
      - text: Save the PNG image file of logo {logo_uuid}.
        slots:
          logo_uuid: path.logo_uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mssp/logos/{logo_uuid}/logo.base64'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a logo as Base64
      effect: read
      questions:
      - Can I get a portal logo as a Base64 string to embed in HTML?
      - Is there a Base64-encoded version of an uploaded logo?
      instructions:
      - text: Get logo {logo_uuid} encoded as Base64.
        slots:
          logo_uuid: path.logo_uuid
      - text: Download the Base64 text of logo {logo_uuid}.
        slots:
          logo_uuid: path.logo_uuid
      method: generated
      generated: '2026-10-01'