# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Marketing Cloud REST Assets API
  version: 1.0.0
extends: openapi/salesforce-assets-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: 5
- target: $.paths['/asset/v1/content/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: List Content Builder assets
      effect: read
      questions:
      - Which emails, images and templates are in Marketing Cloud Content Builder?
      - Can I filter Content Builder assets to a single asset type?
      instructions:
      - text: List my Content Builder assets.
      - text: Show page {page} of assets of type {asset_type}, {page_size} per page.
        slots:
          page: query.page
          asset_type: query.assetType
          page_size: query.pageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/asset/v1/content/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Content Builder asset
      effect: write
      questions:
      - How do I add a new email template to Content Builder?
      - Can I place a new content block into a specific Content Builder category?
      instructions:
      - text: Create a Content Builder asset named {name} of type {asset_type}.
        slots:
          name: requestBody.name
          asset_type: requestBody.assetType
      - text: Add a new asset {name} to category {category} with content {content}.
        slots:
          name: requestBody.name
          category: requestBody.category
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/asset/v1/content/assets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Content Builder asset
      effect: read
      questions:
      - What content and metadata does Content Builder asset 12345 hold?
      - Can I read a single asset's HTML by its numeric ID?
      instructions:
      - text: Get Content Builder asset {id}.
        slots:
          id: path.id
      - text: Show the content and metadata of asset {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/asset/v1/content/assets/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Content Builder asset
      effect: write
      questions:
      - Can I update only one field of a Content Builder asset, or must I resend all of it?
      - How do I change the content of an existing email asset?
      instructions:
      - text: Replace asset {id} with name {name} and content {content}.
        slots:
          id: path.id
          name: requestBody.name
          content: requestBody.content
      - text: Overwrite the definition of Content Builder asset {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/asset/v1/content/assets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Content Builder asset
      effect: destructive
      questions:
      - Can a deleted Content Builder asset be recovered?
      - What should I check before removing an asset used in journeys?
      instructions:
      - text: Delete Content Builder asset {id}.
        slots:
          id: path.id
      - text: Permanently remove asset {id} from Content Builder.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'