# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks Cloud Accounts (All) API
  version: 1.0.0
extends: openapi/palo-alto-networks-cloud-accounts-all-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: 14
- target: $.paths['/account/{accountId}/config/status'].get
  update:
    x-apievangelist-phrasing:
      intent: See which security capabilities are failing for an account
      effect: read
      questions:
      - Why is my cloud account showing warnings or errors in Prisma Cloud?
      - Which security capabilities are in an error state for a cloud account, and how do I fix them?
      instructions:
      - text: Show the capabilities with warnings or errors for cloud account {accountId}.
        slots:
          accountId: path.accountId
      - text: Get remediation suggestions for the status problems on account {accountId}.
        slots:
          accountId: path.accountId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud'].get
  update:
    x-apievangelist-phrasing:
      intent: List all onboarded cloud accounts
      effect: read
      questions:
      - What cloud accounts have been onboarded so far?
      - Can I include accounts that are still pending onboarding in the list?
      instructions:
      - text: List all my onboarded cloud accounts.
      - text: List every cloud account summary, including pending accounts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/name'].get
  update:
    x-apievangelist-phrasing:
      intent: List cloud account names and IDs
      effect: read
      questions:
      - How do I get just the names and IDs of my active cloud accounts?
      - Can I list account names for one cloud type or account group?
      instructions:
      - text: List the names and IDs of active cloud accounts.
      - text: List account names for cloud type {cloudType}.
        slots:
          cloudType: query.cloudType
      - text: Get account names that belong to account groups {accountGroupIds}.
        slots:
          accountGroupIds: query.accountGroupIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/name'].post
  update:
    x-apievangelist-phrasing:
      intent: Filter cloud account names with custom criteria
      effect: read
      questions:
      - Can I filter cloud account names by an arbitrary filter key and value over a time range?
      - Is there a way to look up account names for a specific set of account IDs?
      instructions:
      - text: Find account names where {filterKey} equals {filterValue} over {timeRange}.
        slots:
          filterKey: requestBody.filterKey
          filterValue: requestBody.filterValue
          timeRange: requestBody.timeRange
      - text: Look up names for account IDs {accountIds} within {timeRange}.
        slots:
          accountIds: requestBody.accountIds
          timeRange: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/type'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported cloud types
      effect: read
      questions:
      - Which cloud providers can be onboarded as accounts?
      - Can I see only the cloud types I've actually onboarded?
      instructions:
      - text: List the cloud account types supported.
      - text: Show only the cloud types I have access to.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one cloud account
      effect: read
      questions:
      - How can I see the full details and features of a single cloud account?
      - Can I include account group info when fetching one account?
      instructions:
      - text: Get details for {cloud_type} cloud account {id}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      - text: Show {cloud_type} account {id} including its account group info.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an onboarded cloud account
      effect: destructive
      questions:
      - How do I offboard a cloud account from Prisma Cloud?
      - Can I delete an onboarded account by its cloud type and ID?
      instructions:
      - text: Delete {cloud_type} cloud account {id}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      - text: Offboard the {cloud_type} account with ID {id}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a cloud account’s settings
      effect: write
      questions:
      - Can I change the account groups or auto consent setting on an onboarded account?
      - Is it possible to update child account status along with the parent account?
      instructions:
      - text: Move {cloud_type} account {id} into account groups {groupIds}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
          groupIds: requestBody.groupIds
      - text: Set auto consent to {autoConsent} on {cloud_type} account {id}.
        slots:
          autoConsent: requestBody.autoConsent
          cloud_type: path.cloud_type
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/{id}/project'].get
  update:
    x-apievangelist-phrasing:
      intent: List child accounts under a cloud organization
      effect: read
      questions:
      - Which member accounts are onboarded under my cloud organization?
      - What child projects or accounts belong to an org account?
      instructions:
      - text: List the child accounts of {cloud_type} organization {id}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      - text: Show member accounts onboarded under org {id} on {cloud_type}.
        slots:
          id: path.id
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{id}/owners'].get
  update:
    x-apievangelist-phrasing:
      intent: List the owners of a cloud account
      effect: read
      questions:
      - Who owns a given cloud account?
      - Where can I find the owner email addresses for an account?
      instructions:
      - text: List the owner emails for cloud account {id}.
        slots:
          id: path.id
      - text: Show who owns cloud account {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{id}/status/{enabled}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable ingestion for a cloud account
      effect: write
      questions:
      - Can I pause data ingestion from a cloud account without deleting it?
      - Does disabling an account also disable its child accounts?
      instructions:
      - text: Disable data ingestion for cloud account {id} by setting enabled to {enabled}.
        slots:
          id: path.id
          enabled: path.enabled
      - text: Turn ingestion {enabled} for account {id} and its children.
        slots:
          enabled: path.enabled
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/api/v1/org/{id}/features'].put
  update:
    x-apievangelist-phrasing:
      intent: Toggle a feature for member accounts of an org
      effect: write
      questions:
      - Can I enable a feature for many member accounts of an organization at once?
      - Is there a bulk way to turn features off for org members?
      instructions:
      - text: Update features {features} for members {memberIds} of organization {id}.
        slots:
          features: requestBody.features
          memberIds: requestBody.memberIds
          id: path.id
      - text: Set feature state {features} on member accounts {memberIds} in org {id}.
        slots:
          features: requestBody.features
          memberIds: requestBody.memberIds
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/v1/features/cloud/{cloud_type}'].post
  update:
    x-apievangelist-phrasing:
      intent: List features supported for a cloud type
      effect: read
      questions:
      - What security features can I enable for a given cloud type and account type?
      - Which feature names are supported for an organization versus a single account?
      instructions:
      - text: List supported features for {cloud_type} with account type {accountType}.
        slots:
          cloud_type: path.cloud_type
          accountType: requestBody.accountType
      - text: Fetch the feature names available on {cloud_type} {accountType} accounts.
        slots:
          cloud_type: path.cloud_type
          accountType: requestBody.accountType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/config/v3/account'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a cloud account’s data security config
      effect: write
      questions:
      - Can I save storage scan settings for an account's configuration?
      - What attributes can I set when saving an account config?
      instructions:
      - text: Save the account config for {accountName} with scan option {scanOption}.
        slots:
          accountName: requestBody.accountName
          scanOption: requestBody.scanOption
      - text: Store config for account {accountId} on cloud type {cloudType}.
        slots:
          accountId: requestBody.accountId
          cloudType: requestBody.cloudType
      method: generated
      generated: '2026-09-26'