# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Integrations Pull API
  version: 1.0.0
extends: openapi/palo-alto-networks-integrations-pull-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/integration/name'].get
  update:
    x-apievangelist-phrasing:
      intent: List integration metadata by type
      effect: read
      questions:
      - Where can I find the IDs of my Okta, Qualys or Tenable integrations?
      - Can I list only enabled integrations of one type with their metadata?
      instructions:
      - text: List metadata for all {type} integrations.
        slots:
          type: query.type
      - text: Show metadata for enabled {type} integrations only, onlyEnabled {onlyEnabled}.
        slots:
          type: query.type
          onlyEnabled: query.onlyEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration'].get
  update:
    x-apievangelist-phrasing:
      intent: List all integrations
      effect: read
      questions:
      - Which Okta, Qualys and Tenable integrations are configured in Prisma Cloud?
      - Can I see every integration with its full configuration?
      instructions:
      - text: List all my integrations.
      - text: Show all configured integrations of type {type} with full details.
        slots:
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an Okta, Qualys or Tenable integration
      effect: write
      questions:
      - How do I connect Tenable to Prisma Cloud as a new integration?
      - Which fields are required when adding an integration?
      instructions:
      - text: Add a {integrationType} integration named {name} with config {integrationConfig}.
        slots:
          integrationType: requestBody.integrationType
          name: requestBody.name
          integrationConfig: requestBody.integrationConfig
      - text: Create an Okta integration called {name} using {integrationConfig}.
        slots:
          name: requestBody.name
          integrationConfig: requestBody.integrationConfig
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Test an integration's configuration
      effect: read
      questions:
      - Can I verify that my Qualys credentials work before saving the integration?
      - Is there a way to test an existing integration's connection?
      instructions:
      - text: Test a {integrationType} integration named {name} with config {integrationConfig}.
        slots:
          integrationType: requestBody.integrationType
          name: requestBody.name
          integrationConfig: requestBody.integrationConfig
      - text: Run a connection test for integration {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an integration by ID
      effect: read
      questions:
      - What is configured on one specific integration?
      - Is a particular integration valid and enabled?
      instructions:
      - text: Get integration {id}.
        slots:
          id: path.id
      - text: Show the status and configuration of integration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an integration
      effect: write
      questions:
      - Can I rotate the credentials on an existing Tenable integration?
      - Is it possible to disable an integration without deleting it?
      instructions:
      - text: Update integration {id} with new config {integrationConfig}.
        slots:
          id: path.id
          integrationConfig: requestBody.integrationConfig
      - text: Set integration {id} enabled to {enabled}.
        slots:
          id: path.id
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integration/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an integration
      effect: destructive
      questions:
      - Can I remove an Okta integration I no longer use?
      - What happens when an integration is deleted?
      instructions:
      - text: Delete integration {id}.
        slots:
          id: path.id
      - text: Remove the integration with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'