# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Component Creatives API
  version: 1.0.0
extends: openapi/mediamath-component-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: 17
- target: $.paths['/component_creatives/v1.0/creatives'].get
  update:
    x-apievangelist-phrasing:
      intent: List component creatives (deprecated v1.0)
      effect: read
      questions:
      - Can I still list creatives with the deprecated component creatives v1.0 API?
      - How do I filter v1.0 component creatives by advertiser or status?
      instructions:
      - text: List v1.0 component creatives for advertiser {advertiser_id}.
        slots:
          advertiser_id: query.advertiser_id
      - text: List v1.0 component creatives with status {status}.
        slots:
          status: query.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/creatives'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a component creative (deprecated v1.0)
      effect: write
      questions:
      - Is there a legacy v1.0 call to create a new component creative?
      - What replaced the deprecated v1.0 create-creative endpoint?
      instructions:
      - text: Create a new creative with the deprecated component creatives v1.0 API.
      - text: Make a v1.0 component creative.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/version'].get
  update:
    x-apievangelist-phrasing:
      intent: Get component creatives version info
      effect: read
      questions:
      - Which version of the component creatives service am I talking to?
      - Can I check the group version info for component creatives?
      instructions:
      - text: Get the component creatives group version info.
      - text: Show which component creatives API version is running.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/approvals'].get
  update:
    x-apievangelist-phrasing:
      intent: List creative approvals (deprecated v1.0)
      effect: read
      questions:
      - Where can I see v1.0 approval records for specific atomic creatives?
      - Does the old v1.0 approvals list take a set of atomic creative IDs?
      instructions:
      - text: List v1.0 creative approvals for atomic creatives {atomic_creative_ids}.
        slots:
          atomic_creative_ids: query.atomic_creative_ids
      - text: Show the deprecated v1.0 approvals for creatives {atomic_creative_ids}.
        slots:
          atomic_creative_ids: query.atomic_creative_ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/approvals'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a base64 image or subtitle asset
      effect: write
      questions:
      - Can I upload a base64-encoded image or subtitle file as a creative asset?
      - What format does a subtitle asset upload expect in the v1.0 API?
      instructions:
      - text: Upload a base64 image asset with the v1.0 image-or-subtitle endpoint.
      - text: Post a subtitle file as an asset using session {adama_session}.
        slots:
          adama_session: header.adama_session
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/creatives/{atomic_creative_id}/eligibility'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative's eligibility (deprecated v1.0)
      effect: read
      questions:
      - Is a given creative eligible to serve, according to the v1.0 API?
      - Why might a component creative be ineligible?
      instructions:
      - text: Get v1.0 eligibility details for creative {atomic_creative_id}.
        slots:
          atomic_creative_id: path.atomic_creative_id
      - text: Check whether creative {atomic_creative_id} is eligible to run.
        slots:
          atomic_creative_id: path.atomic_creative_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/creatives/{atomic_creative_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a component creative (deprecated v1.0)
      effect: read
      questions:
      - Can I fetch one component creative's details with the v1.0 API?
      - What does the deprecated v1.0 single-creative lookup return?
      instructions:
      - text: Get v1.0 details of creative {atomic_creative_id}.
        slots:
          atomic_creative_id: path.atomic_creative_id
      - text: Show component creative {atomic_creative_id} without previews.
        slots:
          atomic_creative_id: path.atomic_creative_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/creatives/{atomic_creative_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a component creative (deprecated v1.0)
      effect: write
      questions:
      - Will updating a creative's assets in v1.0 replace its existing assets?
      - How do I keep existing assets when updating a component creative?
      instructions:
      - text: Update v1.0 component creative {atomic_creative_id}.
        slots:
          atomic_creative_id: path.atomic_creative_id
      - text: Update creative {atomic_creative_id} details using session {adama_session}.
        slots:
          atomic_creative_id: path.atomic_creative_id
          adama_session: header.adama_session
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/creatives/{atomic_creative_id}.QUERY.include=previews'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative with preview info
      effect: read
      questions:
      - Can I get a component creative along with its preview links?
      - Which v1.0 call includes previews for an atomic creative?
      instructions:
      - text: Get creative {atomic_creative_id} with its previews.
        slots:
          atomic_creative_id: path.atomic_creative_id
      - text: Show preview info for atomic creative {atomic_creative_id}.
        slots:
          atomic_creative_id: path.atomic_creative_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/assets/{asset_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative text asset
      effect: read
      questions:
      - How can I read the text of a single creative asset?
      - Can I retrieve a text asset by its asset ID?
      instructions:
      - text: Get text asset {asset_id}.
        slots:
          asset_id: path.asset_id
      - text: Show me the content of asset {asset_id}.
        slots:
          asset_id: path.asset_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/assets/{asset_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a creative asset (deprecated v1.0)
      effect: write
      questions:
      - Can I replace the image or text value of an existing asset?
      - Does the v1.0 asset update accept a multipart image upload?
      instructions:
      - text: Update asset {asset_id} with a new image.
        slots:
          asset_id: path.asset_id
      - text: Replace the value of asset {asset_id} using session {adama_session}.
        slots:
          asset_id: path.asset_id
          adama_session: header.adama_session
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/components'].get
  update:
    x-apievangelist-phrasing:
      intent: List creative components (deprecated v1.0)
      effect: read
      questions:
      - What creative components exist in the v1.0 component creatives API?
      - Is there an old endpoint that lists all components?
      instructions:
      - text: List all v1.0 creative components.
      - text: Show me the components available for building creatives.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/components'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a creative component (deprecated v1.0)
      effect: write
      questions:
      - Who is allowed to create a new creative component in v1.0?
      - Why would creating a component return a 401?
      instructions:
      - text: Create a new creative component.
      - text: Create a component using session {adama_session}.
        slots:
          adama_session: header.adama_session
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/components/{component_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative component (deprecated v1.0)
      effect: read
      questions:
      - Can I look up a single creative component by ID?
      - What does one component's definition look like in v1.0?
      instructions:
      - text: Get component {component_id}.
        slots:
          component_id: path.component_id
      - text: Show the definition of creative component {component_id}.
        slots:
          component_id: path.component_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/components/{component_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a creative component (deprecated v1.0)
      effect: write
      questions:
      - Can I edit an existing creative component's definition?
      - Is updating a component still supported in the deprecated v1.0 API?
      instructions:
      - text: Update component {component_id}.
        slots:
          component_id: path.component_id
      - text: Edit the v1.0 creative component {component_id}.
        slots:
          component_id: path.component_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a creative asset
      effect: write
      questions:
      - How do I create a text or image asset and attach it to creatives?
      - Must all creatives get the same new asset belong to one advertiser?
      instructions:
      - text: Create a new asset collection for my creatives.
      - text: Create an asset and associate it with creatives using session {adama_session}.
        slots:
          adama_session: header.adama_session
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v1.0/upload/{filename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pre-signed URL to upload a video
      effect: read
      questions:
      - Where do I upload a video file for a creative asset?
      - Can I get a pre-signed S3 URL for a video asset upload?
      instructions:
      - text: Get a pre-signed upload URL for video file {filename}.
        slots:
          filename: path.filename
      - text: Give me an S3 upload link for {filename}.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-10-01'