# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign Rooms API - v2 Regions API
  version: 1.0.0
extends: openapi/docusign-regions-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}/regions'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions in a Rooms account
      effect: read
      questions:
      - Which regions are set up in my Rooms account?
      - Can I see only the regions I manage?
      instructions:
      - text: List the regions in Rooms account {account}.
        slots:
          account: path.accountId
      - text: Show only the regions I manage in account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/regions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a region in Rooms
      effect: write
      questions:
      - How do I add a new region to my Rooms account?
      - What do I need to provide when creating a region?
      instructions:
      - text: Create a region named {name} in Rooms account {account}.
        slots:
          name: requestBody.name
          account: path.accountId
      - text: Add region {name} to my Rooms setup.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/regions/{regionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Rooms region
      effect: read
      questions:
      - Can I look up one region's name and creation date?
      - Where do I see the details of a specific region?
      instructions:
      - text: Get region {region} in Rooms account {account}.
        slots:
          region: path.regionId
          account: path.accountId
      - text: Show details for region {region}.
        slots:
          region: path.regionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/regions/{regionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Rooms region
      effect: destructive
      questions:
      - Can I remove a region that's no longer used?
      - Why might deleting a region fail?
      instructions:
      - text: Delete region {region} from Rooms account {account}.
        slots:
          region: path.regionId
          account: path.accountId
      - text: Remove the region {region}.
        slots:
          region: path.regionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/regions/{regionId}/reference_counts'].get
  update:
    x-apievangelist-phrasing:
      intent: Count objects that reference a region
      effect: read
      questions:
      - What is still referencing a region I want to delete?
      - How many offices or other objects point at a given region?
      instructions:
      - text: Get reference counts for region {region} in account {account}.
        slots:
          region: path.regionId
          account: path.accountId
      - text: Show which object types still use region {region}.
        slots:
          region: path.regionId
      method: generated
      generated: '2026-10-01'