# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Marketing Campaigns Public Assets API
  version: 1.0.0
extends: openapi/hubspot-assets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/assets/{assetType}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a campaign's assets of one type
      effect: read
      questions:
      - Which landing pages or emails are associated with my marketing campaign?
      - Can I get performance metrics for a campaign's assets over a date range?
      - Do I have to request each asset type separately when listing campaign assets?
      instructions:
      - text: List the {assetType} assets on campaign {campaignGuid}.
        slots:
          assetType: path.assetType
          campaignGuid: path.campaignGuid
      - text: Show campaign {campaignGuid}'s {assetType} assets with metrics from {startDate} to {endDate}.
        slots:
          campaignGuid: path.campaignGuid
          assetType: path.assetType
          startDate: query.startDate
          endDate: query.endDate
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/assets/{assetType}/{assetId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Associate an asset with a campaign
      effect: write
      questions:
      - How do I attach a blog post or form to a marketing campaign?
      - What kinds of assets, like CTAs or marketing emails, can I link to a campaign?
      instructions:
      - text: Add {assetType} asset {assetId} to campaign {campaignGuid}.
        slots:
          assetType: path.assetType
          assetId: path.assetId
          campaignGuid: path.campaignGuid
      - text: Tag campaign {campaignGuid} with existing {assetType} {assetId} so it reports under the campaign.
        slots:
          assetId: path.assetId
          campaignGuid: path.campaignGuid
          assetType: path.assetType
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/assets/{assetType}/{assetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an asset from a campaign
      effect: destructive
      questions:
      - How do I unlink a form or email from a campaign without deleting the asset itself?
      - Can I take a CTA off a campaign it was attached to by mistake?
      instructions:
      - text: Remove {assetType} asset {assetId} from campaign {campaignGuid}.
        slots:
          assetType: path.assetType
          assetId: path.assetId
          campaignGuid: path.campaignGuid
      - text: Disassociate asset {assetId} of type {assetType} from campaign {campaignGuid}.
        slots:
          assetId: path.assetId
          assetType: path.assetType
          campaignGuid: path.campaignGuid
      method: generated
      generated: '2026-09-24'