# 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 Organization Data API
  version: 1.0.0
extends: openapi/edge-impulse-organizationdata-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: 40
- target: $.paths['/api/organizations/{organizationId}/buckets'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's storage buckets
      effect: read
      questions:
      - Which storage buckets are connected to my Edge Impulse organization?
      - Does the bucket list expose the secret keys?
      instructions:
      - text: List the storage buckets of organization {org}.
        slots:
          org: path.organizationId
      - text: Show every bucket configured for organization {org}.
        slots:
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect an external storage bucket
      effect: write
      questions:
      - How do I connect my own S3 or GCS bucket to an organization?
      - Can I connect a bucket when I only have access to a prefix, not the root?
      instructions:
      - text: Add bucket {bucket} at endpoint {endpoint} in region {region} to organization {org} with access key {access} and secret {secret}.
        slots:
          org: path.organizationId
          bucket: requestBody.bucket
          endpoint: requestBody.endpoint
          region: requestBody.region
          access: requestBody.accessKey
          secret: requestBody.secretKey
      - text: Connect storage bucket {bucket} to organization {org}, checking connectivity under prefix {prefix}.
        slots:
          org: path.organizationId
          bucket: requestBody.bucket
          prefix: requestBody.checkConnectivityPrefix
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Test bucket credentials before connecting
      effect: read
      questions:
      - Can I check that new bucket credentials work before I add the bucket?
      - Is there a way to list a few files in a bucket to confirm access ahead of connecting it?
      instructions:
      - text: Verify that bucket {bucket} at {endpoint} is reachable with access key {access} for organization {org}.
        slots:
          org: path.organizationId
          bucket: requestBody.bucket
          endpoint: requestBody.endpoint
          access: requestBody.accessKey
      - text: Test new credentials for bucket {bucket} at endpoint {endpoint} in organization {org} before adding it.
        slots:
          org: path.organizationId
          bucket: requestBody.bucket
          endpoint: requestBody.endpoint
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/{bucketId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage bucket's details
      effect: read
      questions:
      - What endpoint and region is a connected bucket configured with?
      - Can I look up one storage bucket by its ID?
      instructions:
      - text: Get details of bucket {bucket} in organization {org}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
      - text: Show the configuration of storage bucket {bucket} for organization {org}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/{bucketId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a storage bucket's settings
      effect: write
      questions:
      - How do I rotate the access keys on a connected bucket?
      - Do I need to verify connectivity before changing a bucket's credentials?
      instructions:
      - text: Update bucket {bucket} in organization {org} with access key {access} and secret {secret}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
          access: requestBody.accessKey
          secret: requestBody.secretKey
      - text: Change the endpoint of bucket {bucket} in organization {org} to {endpoint}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
          endpoint: requestBody.endpoint
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/{bucketId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a storage bucket
      effect: destructive
      questions:
      - What happens to data when I disconnect a storage bucket from my organization?
      - Can I remove a bucket I no longer use?
      instructions:
      - text: Remove storage bucket {bucket} from organization {org}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
      - text: Disconnect bucket {bucket} from organization {org}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/{bucketId}/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Check access to an already-connected bucket
      effect: read
      questions:
      - Is my already-connected bucket still reachable under a given prefix?
      - Can I re-check connectivity on a bucket that's already set up?
      instructions:
      - text: Verify that existing bucket {bucket} in organization {org} is reachable at prefix {prefix}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
          prefix: requestBody.prefix
      - text: Re-check connectivity of connected bucket {bucket} for organization {org} under {prefix}.
        slots:
          org: path.organizationId
          bucket: path.bucketId
          prefix: requestBody.prefix
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's data items
      effect: read
      questions:
      - What data items are in my organization's datasets?
      - Can I filter organization data items with a SQL-style WHERE clause?
      instructions:
      - text: List data items in organization {org}.
        slots:
          org: path.organizationId
      - text: List data items in dataset {dataset} of organization {org} matching {filter}.
        slots:
          org: path.organizationId
          dataset: query.dataset
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a new data item
      effect: write
      questions:
      - How do I upload files as a new data item in an organization dataset?
      - How many files can I attach directly when adding a data item?
      instructions:
      - text: Add a data item named {name} to dataset {dataset} in organization {org} with metadata {metadata}.
        slots:
          org: path.organizationId
          name: requestBody.name
          dataset: requestBody.dataset
          metadata: requestBody.metadata
      - text: Upload files as new data item {name} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          name: requestBody.name
          dataset: requestBody.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/add-folder'].post
  update:
    x-apievangelist-phrasing:
      intent: Import bucket folders as data items
      effect: write
      questions:
      - Can I bulk-import data that already sits in my bucket, one item per folder?
      - Which bucket path should I point at to add existing folders as data items?
      instructions:
      - text: Add every folder under {path} in bucket {bucket} as data items in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          path: requestBody.bucketPath
          bucket: requestBody.bucketId
          dataset: requestBody.dataset
      - text: Bulk import folders from bucket {bucket} path {path} into dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          path: requestBody.bucketPath
          bucket: requestBody.bucketId
          dataset: requestBody.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download several data items
      effect: read
      questions:
      - Can I download the data for several selected data items at once?
      - Does a multi-item download query the underlying bucket?
      instructions:
      - text: Download data items {ids} from organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
      - text: Download the selected items {ids} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete several data items
      effect: destructive
      questions:
      - Can I bulk-delete many data items in one call?
      - Will deleting selected data items also remove files from my bucket?
      instructions:
      - text: Delete data items {ids} from organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
      - text: Bulk delete selected items {ids} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/clear-checklist'].post
  update:
    x-apievangelist-phrasing:
      intent: Clear checklist flags on data items
      effect: write
      questions:
      - Can I reset the checklist flags on selected data items?
      - Is there a bulk way to clear checklist status across many items?
      instructions:
      - text: Clear the checklist flags for data items {ids} in organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
      - text: Reset checklists on items {ids} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          ids: query.dataIds
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/change-dataset'].post
  update:
    x-apievangelist-phrasing:
      intent: Move data items to another dataset
      effect: write
      questions:
      - Can I move a group of data items into a different dataset?
      - Is it possible to reassign selected items to another dataset in bulk?
      instructions:
      - text: Move data items {ids} in organization {org} to dataset {target}.
        slots:
          org: path.organizationId
          ids: query.dataIds
          target: requestBody.dataset
      - text: Change the dataset of items {ids} in organization {org} to {target}.
        slots:
          org: path.organizationId
          ids: query.dataIds
          target: requestBody.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List files across data items
      effect: read
      questions:
      - Which individual files are included by a data filter across my organization?
      - Can I page through files rather than data items?
      instructions:
      - text: List files in organization {org} matching filter {filter}.
        slots:
          org: path.organizationId
          filter: query.filter
      - text: List the first {limit} files in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          limit: query.limit
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh data items from buckets
      effect: write
      questions:
      - I uploaded files straight to S3; how do I get the data items to reflect them?
      - Will refreshing a dataset drop items that were deleted from the bucket?
      instructions:
      - text: Refresh dataset {dataset} in organization {org} from its buckets.
        slots:
          org: path.organizationId
          dataset: query.dataset
      - text: Resync data items of dataset {dataset} for organization {org} with S3.
        slots:
          org: path.organizationId
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/bulk-metadata'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk update metadata from a CSV
      effect: write
      questions:
      - Can I update metadata for many data items using a CSV file?
      - Which CSV column must identify each item when bulk updating metadata?
      instructions:
      - text: Bulk update metadata in dataset {dataset} of organization {org} using CSV {csv}.
        slots:
          org: path.organizationId
          dataset: requestBody.dataset
          csv: requestBody.csvFile
      - text: Apply metadata from a CSV keyed by name to dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: requestBody.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data item's metadata
      effect: read
      questions:
      - What metadata and files does a specific data item have?
      - Does fetching one data item check the latest file info in the bucket?
      instructions:
      - text: Get data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      - text: Show the metadata of data item {data} for organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a data item's metadata
      effect: write
      questions:
      - Can I rename a single data item or edit its metadata?
      - Is it possible to move one data item to another dataset?
      instructions:
      - text: Rename data item {data} in organization {org} to {name}.
        slots:
          org: path.organizationId
          data: path.dataId
          name: requestBody.name
      - text: Set metadata {metadata} on data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          metadata: requestBody.metadata
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one data item
      effect: destructive
      questions:
      - Can I delete one specific data item?
      - When does removing a single data item also delete it from storage?
      instructions:
      - text: Delete data item {data} from organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      - text: Remove the single item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Add files to an existing data item
      effect: write
      questions:
      - Can I attach more files to a data item that already exists?
      - What do I use when a data item needs files beyond the initial upload?
      instructions:
      - text: Add files to existing data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      - text: Attach {files} to data item {data} of organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          files: requestBody.files[]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download all files of one data item
      effect: read
      questions:
      - Can I download everything stored in one data item?
      - Is there a single download for all of an item's files?
      instructions:
      - text: Download all data for data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      - text: Get every file of item {data} from organization {org} as one download.
        slots:
          org: path.organizationId
          data: path.dataId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/download'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one file from a data item
      effect: destructive
      questions:
      - Can I delete a single file from a data item without removing the whole item?
      - Which parameter names the file to remove from a data item?
      instructions:
      - text: Delete file {file} from data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      - text: Remove {file} out of item {data} for organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/files/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download one file from a data item
      effect: read
      questions:
      - How can I download just one file from a data item?
      - Can I save a single named file out of a data item as an attachment?
      instructions:
      - text: Download file {file} from data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      - text: Save {file} from item {data} of organization {org} to disk.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/files/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview one file from a data item
      effect: read
      questions:
      - Can I view a data item's file inline in the browser instead of downloading it?
      - Might a file preview be truncated?
      instructions:
      - text: Preview file {file} of data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      - text: Show an inline preview of {file} from item {data} for organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          file: query.fileName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/data/{dataId}/transformation-jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List transformation jobs for a data item
      effect: read
      questions:
      - Which transformation jobs have processed a given data item?
      - How many transformation jobs come back if I don't pass a limit?
      instructions:
      - text: List transformation jobs for data item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
      - text: Show the last {limit} transformation jobs that ran on item {data} in organization {org}.
        slots:
          org: path.organizationId
          data: path.dataId
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a research dataset
      effect: write
      questions:
      - How do I create a new research dataset in my organization?
      - Which category, type and bucket must a new dataset specify?
      instructions:
      - text: Add dataset {dataset} of type {type} and category {category} in bucket {bucket} to organization {org} with tags {tags}.
        slots:
          org: path.organizationId
          dataset: requestBody.dataset
          type: requestBody.type
          category: requestBody.category
          bucket: requestBody.bucket
          tags: requestBody.tags
      - text: Create research dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: requestBody.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset's information
      effect: read
      questions:
      - What type, category and tags does a dataset have?
      - Can I look up one dataset by name?
      instructions:
      - text: Get information about dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
      - text: Show the settings of dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a dataset's information
      effect: write
      questions:
      - Can I retag or recategorize an existing dataset?
      - Is it possible to rename a dataset or change its bucket?
      instructions:
      - text: Set the tags of dataset {dataset} in organization {org} to {tags}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          tags: requestBody.tags
      - text: Change dataset {dataset}'s category in organization {org} to {category}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          category: requestBody.category
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/hide'].post
  update:
    x-apievangelist-phrasing:
      intent: Hide a dataset
      effect: write
      questions:
      - Can I hide a dataset without deleting its data?
      - Does hiding a dataset remove the files underneath?
      instructions:
      - text: Hide dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
      - text: Hide the {dataset} dataset from organization {org} but keep its data.
        slots:
          org: path.organizationId
          dataset: path.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/upload-link'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pre-signed upload link
      effect: write
      questions:
      - Can a client upload a file straight to the dataset's bucket with a signed URL?
      - What file details do I need to request a pre-signed S3 upload link?
      instructions:
      - text: Create a signed upload link for {file} ({size} bytes, hash {hash}) in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          file: requestBody.fileName
          size: requestBody.fileSize
          hash: requestBody.fileHash
      - text: Give me a pre-signed S3 URL to upload {file} into dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          file: requestBody.fileName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a dataset is reachable
      effect: read
      questions:
      - Is my dataset's storage reachable, and can I see a few sample files from it?
      - How can I confirm a dataset works as a data source?
      instructions:
      - text: Verify dataset {dataset} in organization {org} is reachable.
        slots:
          org: path.organizationId
          dataset: path.dataset
      - text: Check dataset {dataset} for organization {org} and return some random files.
        slots:
          org: path.organizationId
          dataset: path.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files'].post
  update:
    x-apievangelist-phrasing:
      intent: Browse files and folders in a dataset
      effect: read
      questions:
      - Can I browse the folders and files under a prefix in a dataset?
      - What do I pass to get the next page of more than 1000 dataset files?
      instructions:
      - text: List files and folders under {prefix} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          prefix: requestBody.prefix
      - text: Show only the folders under {prefix} in dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          prefix: requestBody.prefix
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a file from a dataset
      effect: destructive
      questions:
      - Can I delete a file stored in a dataset by its path?
      - Is removing a file from a dataset by path permanent?
      instructions:
      - text: Delete file {path} from dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: requestBody.path
      - text: Remove {path} from the {dataset} dataset of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or move a file in a dataset
      effect: write
      questions:
      - Can I rename a file inside a dataset?
      - Is it possible to move a dataset file to a new path?
      instructions:
      - text: Rename {old} to {new} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          old: requestBody.oldPath
          new: requestBody.newPath
      - text: Move dataset file {old} to {new} within {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          old: requestBody.oldPath
          new: requestBody.newPath
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/download'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a signed download URL for a dataset file
      effect: read
      questions:
      - How do I get a download link for a file in a dataset?
      - Does downloading a dataset file give me a signed URL to the bucket?
      instructions:
      - text: Get a signed download URL for {path} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: requestBody.path
      - text: Download dataset file {path} from {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/download-folder'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a folder from a dataset
      effect: read
      questions:
      - Can I download a whole folder from a dataset at once?
      - Are subdirectories included when I download a dataset folder?
      instructions:
      - text: Download folder {path} from dataset {dataset} in organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: query.path
      - text: Grab every file directly inside {path} of dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: query.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/view'].get
  update:
    x-apievangelist-phrasing:
      intent: View a dataset file in the browser
      effect: read
      questions:
      - Can I view a Parquet or CSV file from a dataset without downloading it?
      - Will viewing a large CSV in a dataset be truncated?
      instructions:
      - text: View file {path} in dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: query.path
      - text: Open {path} from dataset {dataset} for organization {org} in a readable view.
        slots:
          org: path.organizationId
          dataset: path.dataset
          path: query.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dataset/{dataset}/files/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview default-dataset files by wildcard
      effect: read
      questions:
      - Which files would a wildcard prefix match in a default dataset before I start a transformation job?
      - Can I preview only folders matching a pattern in a default dataset?
      instructions:
      - text: Preview {what} matching {prefix} in default dataset {dataset} of organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          prefix: requestBody.prefix
          what: requestBody.itemsToList
      - text: Show which files match wildcard {prefix} in default dataset {dataset} for organization {org}.
        slots:
          org: path.organizationId
          dataset: path.dataset
          prefix: requestBody.prefix
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/buckets/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a bucket in Edge Impulse storage
      effect: write
      questions:
      - Can Edge Impulse host a storage bucket for my organization instead of me bringing one?
      - Which authentication is required to create a managed storage bucket?
      instructions:
      - text: Create a new Edge Impulse-hosted bucket named {name} for organization {org}.
        slots:
          org: path.organizationId
          name: requestBody.name
      - text: Provision managed storage bucket {name} in organization {org}.
        slots:
          org: path.organizationId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'