# 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 Budget API
  version: 1.0.0
extends: openapi/hubspot-budget-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: 5
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/budget'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a budget line item to a campaign
      effect: write
      questions:
      - How do I add a new budget line to a marketing campaign?
      - Can I record planned spend like a paid social budget against a campaign?
      instructions:
      - text: Add a budget item {name} of {amount} to campaign {campaignGuid} at position {order}.
        slots:
          name: requestBody.name
          amount: requestBody.amount
          campaignGuid: path.campaignGuid
          order: requestBody.order
      - text: Create budget line {name} for {amount} on campaign {campaignGuid}, order {order}, with note {description}.
        slots:
          name: requestBody.name
          amount: requestBody.amount
          campaignGuid: path.campaignGuid
          order: requestBody.order
          description: requestBody.description
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/budget/totals'].get
  update:
    x-apievangelist-phrasing:
      intent: See a campaign's total budget, spend and remainder
      effect: read
      questions:
      - How much budget is left on my marketing campaign?
      - What's the total budget versus total spend for a campaign?
      instructions:
      - text: Show the budget totals, spend and remaining budget for campaign {campaignGuid}.
        slots:
          campaignGuid: path.campaignGuid
      - text: Tell me how much of campaign {campaignGuid}'s budget has been spent.
        slots:
          campaignGuid: path.campaignGuid
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/budget/{budgetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one campaign budget item
      effect: read
      questions:
      - How do I look up a single budget line on a campaign by its ID?
      - What amount and notes are stored on a particular campaign budget item?
      instructions:
      - text: Get budget item {budgetId} on campaign {campaignGuid}.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
      - text: Show the amount and description of budget line {budgetId} in campaign {campaignGuid}.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/budget/{budgetId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a campaign budget item
      effect: write
      questions:
      - How do I change the amount on an existing campaign budget line?
      - Can I rename or reorder a budget item I already added to a campaign?
      instructions:
      - text: Change existing budget item {budgetId} on campaign {campaignGuid} to {name}, {amount}, order {order}.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
          name: requestBody.name
          amount: requestBody.amount
          order: requestBody.order
      - text: Update the note on budget line {budgetId} in campaign {campaignGuid} to {description}, keeping name {name}, amount {amount} and order {order}.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
          description: requestBody.description
          name: requestBody.name
          amount: requestBody.amount
          order: requestBody.order
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/campaigns/2026-03/{campaignGuid}/budget/{budgetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a campaign budget item
      effect: destructive
      questions:
      - How do I remove a budget line from a marketing campaign?
      - Can I delete a budget item that was added to the wrong campaign?
      instructions:
      - text: Delete budget item {budgetId} from campaign {campaignGuid}.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
      - text: Remove the budget line {budgetId} from campaign {campaignGuid}'s budget.
        slots:
          budgetId: path.budgetId
          campaignGuid: path.campaignGuid
      method: generated
      generated: '2026-09-24'