# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Content API. Content template API
  version: 1.0.0
extends: openapi/adobe-suite-content-template-api-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: 6
- target: $.paths['/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List content templates
      effect: read
      questions:
      - How do I list the content templates in my Journey Optimizer sandbox?
      - Can I filter templates by name or template type?
      - What's the way to page through a long list of content templates?
      instructions:
      - text: List my content templates.
      - text: List content templates filtered by {property}, ordered by {orderBy}.
        slots:
          property: query.property
          orderBy: query.orderBy
      - text: Show the next {limit} content templates starting at {start}.
        slots:
          limit: query.limit
          start: query.start
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a content template
      effect: write
      questions:
      - How do I create a reusable content template for email or code channels?
      - Can I put a new template straight into a folder when I create it?
      instructions:
      - text: Create a {templateType} content template named {name} for channels {channels}.
        slots:
          templateType: requestBody.templateType
          name: requestBody.name
          channels: requestBody.channels
      - text: Create template {name} of type {templateType} for {channels} in folder {parentFolderId}.
        slots:
          name: requestBody.name
          templateType: requestBody.templateType
          channels: requestBody.channels
          parentFolderId: requestBody.parentFolderId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{templateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a content template by ID
      effect: read
      questions:
      - How do I fetch one content template's full details?
      - Can I get a template's ETag before updating it?
      instructions:
      - text: Show content template {templateId}.
        slots:
          templateId: path.templateId
      - text: Fetch the details of template {templateId}.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{templateId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a content template
      effect: write
      questions:
      - How do I fully overwrite an existing content template with new content?
      - Does replacing a template require the If-Match ETag?
      instructions:
      - text: Replace template {templateId} with name {name}, type {templateType} and channels {channels}.
        slots:
          templateId: path.templateId
          name: requestBody.name
          templateType: requestBody.templateType
          channels: requestBody.channels
      - text: Overwrite template {templateId} at version {etag} with source {source}, keeping name {name}, type {templateType}, channels {channels}.
        slots:
          templateId: path.templateId
          etag: header.If-Match
          source: requestBody.source
          name: requestBody.name
          templateType: requestBody.templateType
          channels: requestBody.channels
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{templateId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a content template
      effect: destructive
      questions:
      - How do I delete a content template I no longer use?
      - Can I remove a template by its ID?
      instructions:
      - text: Delete content template {templateId}.
        slots:
          templateId: path.templateId
      - text: Remove template {templateId} from the sandbox.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{templateId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or move a content template
      effect: write
      questions:
      - Can I just rename a template or change its description without resending the content?
      - How do I move a template to another folder with a JSON Patch?
      instructions:
      - text: Patch template {templateId} at version {etag} to change its name.
        slots:
          templateId: path.templateId
          etag: header.If-Match
      - text: Move template {templateId} to a different folder using a JSON Patch.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'