# 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 Providers API
  version: 1.0.0
extends: openapi/docusign-cloudstorageproviders-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: 5
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's cloud storage connections
      effect: read
      questions:
      - Which cloud storage providers are enabled for my account and connected for a user?
      - Can I see a user's cloud storage configuration with a redirect URL?
      instructions:
      - text: List cloud storage providers for user {userId}.
        slots:
          userId: path.userId
      - text: Show user {userId}'s cloud storage setup in account {accountId} with redirect {redirectUrl}.
        slots:
          userId: path.userId
          accountId: path.accountId
          redirectUrl: query.redirectUrl
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage'].post
  update:
    x-apievangelist-phrasing:
      intent: Set redirect URLs for cloud storage providers
      effect: write
      questions:
      - Can I configure the return redirect URL for a user's cloud storage login?
      - Is it possible to set up redirect information for several storage providers at once?
      instructions:
      - text: Configure cloud storage providers {storageProviders} for user {userId}.
        slots:
          storageProviders: requestBody.storageProviders
          userId: path.userId
      - text: Set the cloud storage redirect URLs for user {userId} in account {accountId}.
        slots:
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a user from several storage providers
      effect: destructive
      questions:
      - Can I clear a user's saved logins for multiple cloud storage providers at once?
      - What happens after a user's cloud storage authentication is deleted?
      instructions:
      - text: Disconnect user {userId} from storage providers {storageProviders}.
        slots:
          userId: path.userId
          storageProviders: requestBody.storageProviders
      - text: Delete cloud storage authentication for user {userId} in account {accountId} across the listed providers.
        slots:
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage/{serviceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one cloud storage provider config for a user
      effect: read
      questions:
      - Is a particular cloud storage service connected for a user?
      - Can I check one storage service's configuration for a specific user?
      instructions:
      - text: Show storage service {serviceId} configuration for user {userId}.
        slots:
          serviceId: path.serviceId
          userId: path.userId
      - text: Get cloud service {serviceId} settings for user {userId} in account {accountId}.
        slots:
          serviceId: path.serviceId
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/cloud_storage/{serviceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a user from one storage provider
      effect: destructive
      questions:
      - Can I remove a user's login for just one cloud storage service?
      - Will the user need to authenticate again after I disconnect one storage service?
      instructions:
      - text: Disconnect user {userId} from storage service {serviceId}.
        slots:
          userId: path.userId
          serviceId: path.serviceId
      - text: Remove the {serviceId} authentication for user {userId} in account {accountId}.
        slots:
          serviceId: path.serviceId
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'