# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LinkedIn Marketing AdAccounts Ad Campaign Groups API
  version: 1.0.0
extends: openapi/linkedin-ad-campaign-groups-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: 4
- target: $.paths['/rest/adAccounts/{adAccountID}/adCampaignGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: Search campaign groups in an ad account
      effect: read
      questions:
      - Which campaign groups sit under my ad account?
      - Can I list campaign groups for one account using a finder?
      instructions:
      - text: Search campaign groups in ad account {adAccountID}.
        slots:
          adAccountID: path.adAccountID
      - text: List campaign groups under {adAccountID} with finder {q}.
        slots:
          adAccountID: path.adAccountID
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/adAccounts/{adAccountID}/adCampaignGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a campaign group
      effect: write
      questions:
      - Can I create a new campaign group to organize campaigns?
      - What do I need to start a campaign group in an ad account?
      instructions:
      - text: Create a campaign group in ad account {adAccountID}.
        slots:
          adAccountID: path.adAccountID
      - text: Set up a new campaign group under {adAccountID}.
        slots:
          adAccountID: path.adAccountID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/adAccounts/{adAccountID}/adCampaignGroups/{campaignGroupID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a campaign group
      effect: read
      questions:
      - What are the settings of one campaign group?
      - Can I retrieve a campaign group by its ID?
      instructions:
      - text: Get campaign group {campaignGroupID} in {adAccountID}.
        slots:
          campaignGroupID: path.campaignGroupID
          adAccountID: path.adAccountID
      - text: Show campaign group {campaignGroupID} from account {adAccountID}.
        slots:
          campaignGroupID: path.campaignGroupID
          adAccountID: path.adAccountID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/adAccounts/{adAccountID}/adCampaignGroups/{campaignGroupID}'].post
  update:
    x-apievangelist-phrasing:
      intent: Partially update a campaign group
      effect: write
      questions:
      - Can I change one field on a campaign group?
      - Is a partial update supported when editing a campaign group?
      instructions:
      - text: Update campaign group {campaignGroupID} in {adAccountID}.
        slots:
          campaignGroupID: path.campaignGroupID
          adAccountID: path.adAccountID
      - text: Patch group {campaignGroupID} of account {adAccountID} to change its status.
        slots:
          campaignGroupID: path.campaignGroupID
          adAccountID: path.adAccountID
      method: generated
      generated: '2026-09-26'