# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for BYOA Custom Brain API
  version: 1.0.0
extends: openapi/mediamath-custom-brain-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: 5
- target: $.paths['/data/{namespace}/models/{model_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom brain model
      effect: read
      questions:
      - What data is stored for a custom brain model?
      - Can I read one model's raw data in a namespace?
      instructions:
      - text: Get model {model_id} in namespace {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      - text: Show the raw data for custom brain model {model_id} under {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/{namespace}/models/{model_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload custom brain model data
      effect: write
      questions:
      - How do I upload data for my own custom brain model?
      - Which brain type do I need to specify when uploading model data?
      instructions:
      - text: Upload data {data} to model {model_id} in namespace {namespace} with brain type {brain_type_id}.
        slots:
          data: requestBody.data
          model_id: path.model_id
          namespace: path.namespace
          brain_type_id: requestBody.brain_type_id
      - text: Replace model {model_id} in {namespace} with new data {data}, brain type {brain_type_id}.
        slots:
          model_id: path.model_id
          namespace: path.namespace
          data: requestBody.data
          brain_type_id: requestBody.brain_type_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/{namespace}/models/{model_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom brain model
      effect: destructive
      questions:
      - Can I delete a custom brain model I uploaded?
      - Is removing a model from a namespace permanent?
      instructions:
      - text: Delete model {model_id} from namespace {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      - text: Remove custom brain model {model_id} in {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/decode/{namespace}/models/{model_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a decoded custom brain model
      effect: read
      questions:
      - Can I see a custom brain model's data in decoded, readable form?
      - Is there a decode view for model data?
      instructions:
      - text: Get decoded data for model {model_id} in namespace {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      - text: Decode custom brain model {model_id} under {namespace}.
        slots:
          namespace: path.namespace
          model_id: path.model_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/{namespace}'].get
  update:
    x-apievangelist-phrasing:
      intent: List all models in a namespace
      effect: read
      questions:
      - Which custom brain models live in a namespace?
      - Can I get every model and its data for one namespace?
      instructions:
      - text: List all models and data in namespace {namespace}.
        slots:
          namespace: path.namespace
      - text: Show models in namespace {namespace} filtered to model {model_id}.
        slots:
          namespace: path.namespace
          model_id: query.model_id
      method: generated
      generated: '2026-10-01'