# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Video Creatives Classification (V3) API
  version: 1.0.0
extends: openapi/mediamath-classification-v3-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: 7
- target: $.paths['/v3.0/classification/{cid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative's classification
      effect: read
      questions:
      - How is a creative classified by language and vertical?
      - Can I read the saved classification for one atomic creative?
      instructions:
      - text: Get the classification for creative {cid}.
        slots:
          cid: path.cid
      - text: Show the verticals and language saved for creative {cid}.
        slots:
          cid: path.cid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/{cid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a creative's classification
      effect: write
      questions:
      - Can I set the language and verticals for a creative?
      - What attributes can I save on a creative's classification?
      instructions:
      - text: Save classification for creative {cid} with verticals {verticals}.
        slots:
          cid: path.cid
          verticals: requestBody.verticals
      - text: Classify creative {cid} as language {language}.
        slots:
          cid: path.cid
          language: requestBody.language
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/{cid}/force-publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Force-publish a creative's classification
      effect: write
      questions:
      - Can I push a creative's classification live immediately?
      - What does force-publishing a classification do?
      instructions:
      - text: Force-publish the classification for creative {cid}.
        slots:
          cid: path.cid
      - text: Publish creative {cid}'s classification right now.
        slots:
          cid: path.cid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/{cid}/inflate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative's inflated classification
      effect: read
      questions:
      - Can I get a creative's classification with names expanded instead of IDs?
      - Is there a fuller, inflated view of one creative's classification?
      instructions:
      - text: Get the inflated classification for creative {cid}.
        slots:
          cid: path.cid
      - text: Show creative {cid}'s classification expanded.
        slots:
          cid: path.cid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Save classifications for many creatives
      effect: write
      questions:
      - Can I classify a batch of creatives in one request?
      - How do I bulk save creative classifications?
      instructions:
      - text: Save classifications in bulk for records {records}.
        slots:
          records: requestBody.records
      - text: Bulk classify creatives using {records}.
        slots:
          records: requestBody.records
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/bulk/{cids}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get classifications for several creatives
      effect: read
      questions:
      - Can I fetch classifications for a comma-separated list of creatives?
      - Which classifications are saved for a group of atomic creatives?
      instructions:
      - text: Get classifications for creatives {cids}.
        slots:
          cids: path.cids
      - text: Show saved classifications for creatives {cids} at once.
        slots:
          cids: path.cids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.0/classification/bulk/{cids}/inflate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get inflated classifications for several creatives
      effect: read
      questions:
      - Can I get expanded classifications for many creatives in one call?
      - Is there a bulk inflated classification lookup?
      instructions:
      - text: Get inflated classifications for creatives {cids}.
        slots:
          cids: path.cids
      - text: Show expanded classifications for creatives {cids}.
        slots:
          cids: path.cids
      method: generated
      generated: '2026-10-01'