# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Atomic Creatives API
  version: 1.0.0
extends: openapi/mediamath-atomic-creatives-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/creative_draft'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview creative assets before upload
      effect: read
      questions:
      - Can I check my creative files and metadata before committing the upload?
      - What would be created if I uploaded these creative assets?
      instructions:
      - text: Preview creative file {file} with metadata {metadata} without saving it.
        slots:
          file: requestBody.filename
          metadata: requestBody.metadata
      - text: Do a dry run of creative file {file} with metadata {metadata} to see what would be created.
        slots:
          file: requestBody.filename
          metadata: requestBody.metadata
      method: generated
      generated: '2026-10-01'
- target: $.paths['/creative_upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload creative assets
      effect: write
      questions:
      - How do I upload creative files so they become atomic creatives?
      - Once uploaded, are creative assets stored permanently?
      instructions:
      - text: Upload creative file {file} with metadata {metadata}.
        slots:
          file: requestBody.filename
          metadata: requestBody.metadata
      - text: Permanently upload creative file {file} with metadata {metadata} as atomic creatives.
        slots:
          file: requestBody.filename
          metadata: requestBody.metadata
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives'].get
  update:
    x-apievangelist-phrasing:
      intent: List atomic creatives
      effect: read
      questions:
      - Which display creatives exist in my MediaMath account?
      - Can I get the extended details for every atomic creative?
      instructions:
      - text: List my atomic creatives.
      - text: Show every atomic creative with extended details.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an atomic creative
      effect: write
      questions:
      - How do I create a creative from an ad tag with a set width and height?
      - What is required to add a new atomic creative for an advertiser?
      instructions:
      - text: Create atomic creative {name} sized {width}x{height} for advertiser {advertiser}.
        slots:
          name: requestBody.name
          width: requestBody.width
          height: requestBody.height
          advertiser: requestBody.advertiser_id
      - text: Create atomic creative {name} for advertiser {advertiser} using tag {tag}.
        slots:
          name: requestBody.name
          advertiser: requestBody.advertiser_id
          tag: requestBody.tag
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives/{atomic_creative_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an atomic creative
      effect: read
      questions:
      - What are the settings of a specific atomic creative?
      - Can I look up one creative's tag and click URL by ID?
      instructions:
      - text: Get atomic creative {creative}.
        slots:
          creative: path.atomic_creative_id
      - text: Show the settings of atomic creative {creative}.
        slots:
          creative: path.atomic_creative_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives/{atomic_creative_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an atomic creative
      effect: write
      questions:
      - How do I change the click-through URL on an existing atomic creative?
      - Can I archive or rename an atomic creative?
      instructions:
      - text: Set the click-through URL of atomic creative {creative} to {url}.
        slots:
          creative: path.atomic_creative_id
          url: requestBody.click_through_url
      - text: Rename atomic creative {creative} to {name}.
        slots:
          creative: path.atomic_creative_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives/{atomic_creative_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View an atomic creative's change history
      effect: read
      questions:
      - Who edited this atomic creative and when?
      - Where is the audit log for one creative?
      instructions:
      - text: Show the audit log for atomic creative {creative}.
        slots:
          creative: path.atomic_creative_id
      - text: List the changes made to atomic creative {creative}.
        slots:
          creative: path.atomic_creative_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/atomic_creatives/healthcheck'].get
  update:
    x-apievangelist-phrasing:
      intent: Check atomic creatives' health
      effect: read
      questions:
      - Are my atomic creatives healthy and ready to serve?
      - Can I run a health check on several creatives by ID?
      instructions:
      - text: Run a health check on atomic creatives {ids}.
        slots:
          ids: query.q
      - text: Check whether atomic creatives {ids} are healthy.
        slots:
          ids: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_update/atomic_creatives'].post
  update:
    x-apievangelist-phrasing:
      intent: Update multiple atomic creatives
      effect: write
      questions:
      - Can I edit many atomic creatives in one request?
      - How do I bulk change settings across a batch of creatives?
      instructions:
      - text: Bulk update atomic creatives {creatives}.
        slots:
          creatives: requestBody.atomic_creatives
      - text: 'Apply these edits to many atomic creatives at once: {creatives}.'
        slots:
          creatives: requestBody.atomic_creatives
      method: generated
      generated: '2026-10-01'