# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Concepts API
  version: 1.0.0
extends: openapi/mediamath-concepts-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: 6
- target: $.paths['/concepts'].get
  update:
    x-apievangelist-phrasing:
      intent: List creative concepts
      effect: read
      questions:
      - Which creative concepts does my account have?
      - Can I filter concepts by media type?
      instructions:
      - text: List my concepts.
      - text: List concepts with media type {media_type}.
        slots:
          media_type: query.media_type
      - text: Find concepts matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/concepts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a creative concept
      effect: write
      questions:
      - How do I create a concept to group creatives for an advertiser?
      - What is required to make a new concept?
      instructions:
      - text: Create concept {name} for advertiser {advertiser_id}.
        slots:
          name: requestBody.name
          advertiser_id: requestBody.advertiser_id
      - text: Add concept {name} under advertiser {advertiser_id} with status {status}.
        slots:
          name: requestBody.name
          advertiser_id: requestBody.advertiser_id
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/concepts/{concept_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative concept
      effect: read
      questions:
      - What are the details of one concept?
      - Can I look up a concept by its ID?
      instructions:
      - text: Get concept {concept_id}.
        slots:
          concept_id: path.concept_id
      - text: Show concept {concept_id}'s status and advertiser.
        slots:
          concept_id: path.concept_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/concepts/{concept_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a creative concept
      effect: write
      questions:
      - Can I rename or archive an existing concept?
      - What does updating a single concept require?
      instructions:
      - text: Rename concept {concept_id} to {name}.
        slots:
          concept_id: path.concept_id
          name: requestBody.name
      - text: Archive concept {concept_id}, keeping name {name}.
        slots:
          concept_id: path.concept_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/concepts/{concept_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a concept's change history
      effect: read
      questions:
      - Who changed this concept and when?
      - Can I see the audit trail for a concept?
      instructions:
      - text: Show the change history for concept {concept_id}.
        slots:
          concept_id: path.concept_id
      - text: Get the audit log of concept {concept_id}.
        slots:
          concept_id: path.concept_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_update/concepts'].post
  update:
    x-apievangelist-phrasing:
      intent: Update many concepts at once
      effect: write
      questions:
      - Can I update several concepts in one request?
      - How do I bulk archive or rename concepts?
      instructions:
      - text: Bulk update concepts {concepts}.
        slots:
          concepts: requestBody.concepts
      - text: 'Apply these changes to multiple concepts: {concepts}.'
        slots:
          concepts: requestBody.concepts
      method: generated
      generated: '2026-10-01'