# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Cloud Storage API
  version: 1.0.0
extends: openapi/docusign-cloud-storage-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: 2
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage/{serviceId}/folders'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse items across a user's cloud storage folders
      effect: read
      questions:
      - Can I search through everything a user has in a connected cloud storage service?
      - Can I browse a cloud storage path and sort the results?
      instructions:
      - text: List items in cloud storage service {serviceId} for user {userId}.
        slots:
          serviceId: path.serviceId
          userId: path.userId
      - text: Search {serviceId} storage of user {userId} in account {accountId} for {search_text}.
        slots:
          serviceId: path.serviceId
          userId: path.userId
          accountId: path.accountId
          search_text: query.search_text
      - text: Browse path {cloud_storage_folder_path} in service {serviceId} for user {userId}.
        slots:
          cloud_storage_folder_path: query.cloud_storage_folder_path
          serviceId: path.serviceId
          userId: path.userId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage/{serviceId}/folders/{folderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: List items in a specific cloud storage folder
      effect: read
      questions:
      - What files are inside one particular folder of a user's cloud storage?
      - Can I open a cloud storage folder by its folder ID?
      instructions:
      - text: List the contents of folder {folderId} in service {serviceId} for user {userId}.
        slots:
          folderId: path.folderId
          serviceId: path.serviceId
          userId: path.userId
      - text: Show folder {folderId} items from cloud service {serviceId} for user {userId} in account {accountId}.
        slots:
          folderId: path.folderId
          serviceId: path.serviceId
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'