# 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 Group Brands API
  version: 1.0.0
extends: openapi/docusign-groupbrands-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: 3
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/brands'].get
  update:
    x-apievangelist-phrasing:
      intent: List brands assigned to a group
      effect: read
      questions:
      - Which brands can members of a group use?
      - How can I see a group's brand assignments?
      instructions:
      - text: List brands for group {group} in account {account}.
        slots:
          group: path.groupId
          account: path.accountId
      - text: Show the brands assigned to group {group}.
        slots:
          group: path.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/brands'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign brands to a group
      effect: write
      questions:
      - Can I give a group access to specific sending brands?
      - How do I add a brand to a user group?
      instructions:
      - text: Add brands {brands} to group {group} in account {account}.
        slots:
          brands: requestBody.brands
          group: path.groupId
          account: path.accountId
      - text: Assign brand set {brands} to group {group}.
        slots:
          brands: requestBody.brands
          group: path.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/brands'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove brands from a group
      effect: destructive
      questions:
      - How do I take a brand away from a group?
      - Can I unassign several brands from a group at once?
      instructions:
      - text: Remove brands {brands} from group {group} in account {account}.
        slots:
          brands: requestBody.brands
          group: path.groupId
          account: path.accountId
      - text: Unassign brand set {brands} from group {group}.
        slots:
          brands: requestBody.brands
          group: path.groupId
      method: generated
      generated: '2026-10-01'