API Evangelist conversational phrasing for Edge Impulse Raw data API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Edge Impulse Raw data API
  version: 1.0.0
extends: openapi/edge-impulse-raw-data-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: 66
- target: $.paths['/api/{projectId}/raw-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List data samples in a dataset category
      effect: read
      questions:
      - What samples are in the training set of my Edge Impulse project?
      - Can I page through test samples filtered by label or filename?
      - Which samples fall between a minimum and maximum length?
      instructions:
      - text: List the {category} samples in project {projectId}.
        slots:
          category: query.category
          projectId: path.projectId
      - text: List {category} samples labeled {labels} in project {projectId}, {limit} at a time.
        slots:
          category: query.category
          labels: query.labels
          projectId: path.projectId
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count data samples in a dataset category
      effect: read
      questions:
      - How many training samples does my project have?
      - What's the number of test samples carrying a particular label?
      instructions:
      - text: Count the {category} samples in project {projectId}.
        slots:
          category: query.category
          projectId: path.projectId
      - text: Tell me how many {category} samples in project {projectId} are labeled {labels}.
        slots:
          category: query.category
          projectId: path.projectId
          labels: query.labels
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/label-object-detection-queue'].get
  update:
    x-apievangelist-phrasing:
      intent: Get images waiting for bounding-box labeling
      effect: read
      questions:
      - Which images still need bounding boxes drawn in my object detection project?
      - Where do I find the unlabeled items in the labeling queue?
      instructions:
      - text: List the unlabeled items in the object detection queue for project {projectId}.
        slots:
          projectId: path.projectId
      - text: Show the images awaiting bounding-box labels in project {projectId}.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/label-object-detection-queue/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count items in the object detection labeling queue
      effect: read
      questions:
      - How many images are left to label in my object detection queue?
      - Is my bounding-box labeling queue empty yet?
      instructions:
      - text: Count the unlabeled items in the object detection queue for project {projectId}.
        slots:
          projectId: path.projectId
      - text: Tell me how many images remain in the labeling queue of project {projectId}.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/rebalance'].post
  update:
    x-apievangelist-phrasing:
      intent: Rebalance train/test split (original endpoint)
      effect: write
      questions:
      - How do I reset my dataset to an 80/20 train-test split using the original rebalance endpoint?
      - Will the older rebalance call reassign every sample deterministically?
      instructions:
      - text: Rebalance project {projectId} to 80/20 train/test using the original v1 rebalance endpoint.
        slots:
          projectId: path.projectId
      - text: Run the legacy dataset rebalance on project {projectId}.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/clear-all-object-detection-labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Clear all bounding-box labels in a project
      effect: destructive
      questions:
      - How do I wipe every bounding box in my dataset and start labeling over?
      - Can I send all images back to the labeling queue in one go?
      instructions:
      - text: Clear all object detection labels in project {projectId}.
        slots:
          projectId: path.projectId
      - text: Remove every bounding box from project {projectId} and requeue all images for labeling.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/delete-all'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete all samples in a project
      effect: destructive
      questions:
      - How do I delete my entire dataset across training and testing?
      - Does removing all samples also invalidate my DSP and learn blocks?
      instructions:
      - text: Delete every sample in project {projectId} across all categories.
        slots:
          projectId: path.projectId
      - text: Wipe the whole dataset of project {projectId}.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/delete-all/{category}'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete all samples in one category
      effect: destructive
      questions:
      - Can I delete just the test set while keeping training data?
      - How do I remove every sample in a single dataset category?
      instructions:
      - text: Delete all {category} samples in project {projectId}.
        slots:
          category: path.category
          projectId: path.projectId
      - text: Clear out the {category} category of project {projectId}.
        slots:
          category: path.category
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metadata for all samples in a category
      effect: read
      questions:
      - What metadata is attached to every training sample in my project?
      - Can I export the metadata of all test samples at once?
      instructions:
      - text: Get metadata for all {category} samples in project {projectId}.
        slots:
          category: query.category
          projectId: path.projectId
      - text: Show sample metadata across the {category} set of project {projectId}.
        slots:
          category: query.category
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/imported-from'].get
  update:
    x-apievangelist-phrasing:
      intent: List samples with 'imported from' metadata
      effect: read
      questions:
      - Which items from my data source have already been imported into the project?
      - Can I see every sample tagged with an 'imported from' origin?
      instructions:
      - text: List samples with an imported-from key in project {projectId}.
        slots:
          projectId: path.projectId
      - text: Show {limit} already-imported data items in project {projectId}.
        slots:
          limit: query.limit
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single data sample
      effect: read
      questions:
      - What are the sensor values and label of a specific sample?
      - Can I fetch one sample but cap the number of payload values returned?
      instructions:
      - text: Get sample {sampleId} from project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Fetch sample {sampleId} in project {projectId} limited to {limitPayloadValues} values.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          limitPayloadValues: query.limitPayloadValues
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single sample
      effect: destructive
      questions:
      - How do I remove one bad sample from my dataset?
      - Does deleting a sample also remove it from cold storage?
      instructions:
      - text: Delete sample {sampleId} from project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Remove the single sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/raw'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a sample in its original format
      effect: read
      questions:
      - Can I download a sample exactly as it was uploaded to the ingestion service?
      - How do I get the original file behind a sample?
      instructions:
      - text: Download the original uploaded file for sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Get sample {sampleId} from project {projectId} in its raw uploaded format.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/wav'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an audio sample as a WAV file
      effect: read
      questions:
      - How do I listen to an audio sample as a WAV file?
      - Can I export just a time slice of an audio sample?
      instructions:
      - text: Get sample {sampleId} in project {projectId} as WAV using axis {axisIx}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          axisIx: query.axisIx
      - text: Export axis {axisIx} of sample {sampleId} in project {projectId} as WAV from {sliceStart} to {sliceEnd}.
        slots:
          axisIx: query.axisIx
          sampleId: path.sampleId
          projectId: path.projectId
          sliceStart: query.sliceStart
          sliceEnd: query.sliceEnd
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an image sample as an image file
      effect: read
      questions:
      - How do I view an RGBA sample as an image file?
      - Can I see what an image looks like after the impulse's input block processes it?
      instructions:
      - text: Get sample {sampleId} in project {projectId} as an image file.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Render image sample {sampleId} from project {projectId} after the input block of impulse {impulseId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          impulseId: query.impulseId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/video'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a video sample as a video file
      effect: read
      questions:
      - How do I play back a video sample from my dataset?
      - Can I download a sample containing video data as a video file?
      instructions:
      - text: Get sample {sampleId} in project {projectId} as a video file.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Download the video for sample {sampleId} of project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/slice'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slice of a sample's data
      effect: read
      questions:
      - Can I fetch only part of a long sample's data between two points?
      - How do I read a window of values from a sample starting at a given offset?
      instructions:
      - text: Get a slice of sample {sampleId} in project {projectId} starting at {sliceStart}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          sliceStart: query.sliceStart
      - text: Return sample {sampleId} data from {sliceStart} to {sliceEnd} in project {projectId}.
        slots:
          sampleId: path.sampleId
          sliceStart: query.sliceStart
          sliceEnd: query.sliceEnd
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a sample
      effect: write
      questions:
      - How do I change the file name of a sample?
      - Do sample names need to be unique within a project?
      instructions:
      - text: Rename sample {sampleId} in project {projectId} to {name}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          name: requestBody.name
      - text: Set the file name of sample {sampleId} in project {projectId} to {name}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/edit-label'].post
  update:
    x-apievangelist-phrasing:
      intent: Change the label of one sample
      effect: write
      questions:
      - How do I fix the class label on a single mislabeled sample?
      - Can I relabel one sample without touching the rest of the dataset?
      instructions:
      - text: Set the label of sample {sampleId} in project {projectId} to {label}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          label: requestBody.label
      - text: Relabel just sample {sampleId} of project {projectId} as {label}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          label: requestBody.label
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move one sample to another category
      effect: write
      questions:
      - How do I move a single sample from the test set into training?
      - Can I reassign one sample's dataset category?
      instructions:
      - text: Move sample {sampleId} in project {projectId} to {newCategory}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          newCategory: requestBody.newCategory
      - text: Put the single sample {sampleId} of project {projectId} into the {newCategory} set.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          newCategory: requestBody.newCategory
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/crop'].post
  update:
    x-apievangelist-phrasing:
      intent: Crop a sample to a new range
      effect: write
      questions:
      - How do I trim the silence off the start and end of a recording?
      - Can I crop a sample to keep only a section between two points?
      instructions:
      - text: Crop sample {sampleId} in project {projectId} from {cropStart} to {cropEnd}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          cropStart: requestBody.cropStart
          cropEnd: requestBody.cropEnd
      - text: Trim sample {sampleId} of project {projectId} to the range {cropStart} through {cropEnd}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          cropStart: requestBody.cropStart
          cropEnd: requestBody.cropEnd
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/split'].post
  update:
    x-apievangelist-phrasing:
      intent: Split a video sample into frames
      effect: write
      questions:
      - How do I turn a video sample into individual image frames?
      - Can I choose the frame rate when splitting a video into frames?
      instructions:
      - text: Split video sample {sampleId} in project {projectId} into frames.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Extract frames from video {sampleId} of project {projectId} at {fps} fps.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          fps: requestBody.fps
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/find-segments'].post
  update:
    x-apievangelist-phrasing:
      intent: Detect non-noise events in a sample
      effect: read
      questions:
      - Can Edge Impulse automatically find where the interesting events are in a long recording?
      - How do I get start and end times for every non-noise event in a sample?
      instructions:
      - text: Find segments in sample {sampleId} of project {projectId} with {segmentLengthMs} ms segments.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          segmentLengthMs: requestBody.segmentLengthMs
      - text: Detect events in sample {sampleId} in project {projectId}, {segmentLengthMs} ms long, shifting segments {shiftSegments}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          segmentLengthMs: requestBody.segmentLengthMs
          shiftSegments: requestBody.shiftSegments
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Slice a sample into multiple segments
      effect: write
      questions:
      - How do I cut one long sample into several shorter samples?
      - What happens to the original file after I segment a sample?
      instructions:
      - text: Segment sample {sampleId} in project {projectId} into {segments}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          segments: requestBody.segments
      - text: 'Slice sample {sampleId} of project {projectId} at these segment boundaries: {segments}.'
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          segments: requestBody.segments
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/bounding-boxes'].post
  update:
    x-apievangelist-phrasing:
      intent: Set bounding boxes on one sample
      effect: write
      questions:
      - How do I save bounding-box annotations for a single image?
      - Can I replace the object boxes drawn on one sample?
      instructions:
      - text: Set the bounding boxes of sample {sampleId} in project {projectId} to {boundingBoxes}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          boundingBoxes: requestBody.boundingBoxes
      - text: Annotate image {sampleId} of project {projectId} with boxes {boundingBoxes}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          boundingBoxes: requestBody.boundingBoxes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/structured-labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Set multiple time-ranged labels on a sample
      effect: write
      questions:
      - Can one sample carry several labels over different time ranges?
      - How do I label parts of a sample with start and end indexes?
      instructions:
      - text: Set structured labels {structuredLabels} on sample {sampleId} in project {projectId}.
        slots:
          structuredLabels: requestBody.structuredLabels
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Give sample {sampleId} of project {projectId} multi-label ranges {structuredLabels}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          structuredLabels: requestBody.structuredLabels
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/store-segment-length'].post
  update:
    x-apievangelist-phrasing:
      intent: Remember the last segment length used
      effect: write
      questions:
      - Can the project remember my segment length so all segments come out uniform?
      - How do I save a default segment length for future segmenting?
      instructions:
      - text: Store a segment length of {segmentLength} for project {projectId}.
        slots:
          segmentLength: requestBody.segmentLength
          projectId: path.projectId
      - text: Remember {segmentLength} as the last segment length in project {projectId}.
        slots:
          segmentLength: requestBody.segmentLength
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/original'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample's original uncropped data
      effect: read
      questions:
      - Can I see a sample's data as it was before I cropped it?
      - How do I zoom into a range of the original downsampled signal?
      instructions:
      - text: Get the original uncropped data for sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Show uncropped downsampled data of sample {sampleId} in project {projectId} zoomed from {zoomStart} to {zoomEnd}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          zoomStart: query.zoomStart
          zoomEnd: query.zoomEnd
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/retry-processing'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry processing a failed sample
      effect: write
      questions:
      - What can I do about a sample that failed processing after upload?
      - Is there a way to reprocess a single broken sample?
      instructions:
      - text: Retry processing sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Reprocess failed sample {sampleId} of project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/enable'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-include one sample in the dataset
      effect: write
      questions:
      - How do I bring a disabled sample back into my dataset?
      - Can I re-enable a single excluded sample?
      instructions:
      - text: Enable sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Include the single sample {sampleId} of project {projectId} in the dataset again.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Exclude one sample from the dataset
      effect: write
      questions:
      - Can I exclude one sample from training without deleting it?
      - How do I temporarily disable a single questionable sample?
      instructions:
      - text: Disable sample {sampleId} in project {projectId}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Exclude the single sample {sampleId} of project {projectId} from the dataset.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/autolabel'].post
  update:
    x-apievangelist-phrasing:
      intent: Auto-label an image with another neural network
      effect: write
      questions:
      - Can another neural network classify an image for me automatically?
      - How do I auto-label one image sample?
      instructions:
      - text: Auto-label image {sampleId} in project {projectId} using {neuralNetwork}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          neuralNetwork: requestBody.neuralNetwork
      - text: Classify sample {sampleId} of project {projectId} with neural network {neuralNetwork}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          neuralNetwork: requestBody.neuralNetwork
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/metadata'].post
  update:
    x-apievangelist-phrasing:
      intent: Set metadata on one sample
      effect: write
      questions:
      - How do I attach metadata such as device or location to a single sample?
      - Can I update the key-value metadata on one sample?
      instructions:
      - text: Set metadata {metadata} on sample {sampleId} in project {projectId}.
        slots:
          metadata: requestBody.metadata
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Update the single sample {sampleId} of project {projectId} with metadata {metadata}.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
          metadata: requestBody.metadata
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/to-labeling-queue'].post
  update:
    x-apievangelist-phrasing:
      intent: Send one sample back to the labeling queue
      effect: destructive
      questions:
      - How do I redo the bounding boxes on a single image?
      - Can I clear one image's boxes and put it back in the labeling queue?
      instructions:
      - text: Move sample {sampleId} in project {projectId} back to the labeling queue.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      - text: Clear the boxes on image {sampleId} of project {projectId} and requeue it for labeling.
        slots:
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/{sampleId}/propose-changes'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue AI Actions proposed changes for a sample
      effect: write
      questions:
      - How do I stage changes to a sample as part of an AI Actions job?
      - Will proposing new changes overwrite earlier proposals for the same sample?
      instructions:
      - text: Propose changes {proposedChanges} to sample {sampleId} in project {projectId} for AI Actions job {jobId}.
        slots:
          proposedChanges: requestBody.proposedChanges
          sampleId: path.sampleId
          projectId: path.projectId
          jobId: requestBody.jobId
      - text: Queue job {jobId} proposals {proposedChanges} on sample {sampleId} of project {projectId}.
        slots:
          jobId: requestBody.jobId
          proposedChanges: requestBody.proposedChanges
          sampleId: path.sampleId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/batch/edit-labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Relabel many samples at once
      effect: write
      questions:
      - How do I change the label on a whole batch of samples in one call?
      - Can I relabel every training sample whose filename matches a pattern?
      instructions:
      - text: Relabel all {category} samples currently labeled {labels} in project {projectId} as {label}.
        slots:
          category: query.category
          labels: query.labels
          projectId: path.projectId
          label: requestBody.label
      - text: Set label {label} on {category} samples {ids} in project {projectId}.
        slots:
          label: requestBody.label
          category: query.category
          ids: query.ids
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/batch/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete many samples matching a filter
      effect: destructive
      questions:
      - How do I delete every sample with a particular label in bulk?
      - Can I remove a specific list of sample IDs in one request?
      instructions:
      - text: Delete all {category} samples labeled {labels} in project {projectId}.
        slots:
          category: query.category
          labels: query.labels
          projectId: path.projectId
      - text: Bulk delete {category} samples {ids} from project {projectId}.
        slots:
          category: query.category
          ids: query.ids
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/batch/moveSamples'].post
  update:
    x-apievangelist-phrasing:
      intent: Move many samples to another category
      effect: write
      questions:
      - How do I move a batch of test samples into the training set?
      - Can I shift all samples of one label to a different category at once?
      instructions:
      - text: Move all {category} samples labeled {labels} in project {projectId} to {newCategory}.
        slots:
          category: query.category
          labels: query.labels
          projectId: path.projectId
          newCategory: requestBody.newCategory
      - text: Bulk move {category} samples {ids} of project {projectId} into {newCategory}.
        slots:
          category: query.category
          ids: query.ids
          projectId: path.projectId
          newCategory: requestBody.newCategory
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/{projectId}/raw-data/batch/enable-samples'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-include many samples in the dataset
      effect: write
      questions:
      - How do I re-enable a whole group of disabled samples?
      - Can I bring back every excluded sample with a given label?
      instructions:
      - text: Enable all {category} samples labeled {labels} in project {projectId}.
        slots:
          category: query.category
          labels: query.labels
          projectId: path.projectId
      - text: Bulk enable {category} samples {ids} in project {projectId}.
        slots:
          category: query.category
          ids: query.ids
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/edge-impulse/refs/heads/main/overlays/edge-impulse-raw-data-api-phrasing-overlay.yaml