Edge Impulse OrganizationData API
The OrganizationData API from Edge Impulse — 32 operation(s) for organizationdata.
Operations 40
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
GET
/api/organizations/{organizationId}/buckets
List an organization's storage buckets · List storage buckets
#
Ask an LLM
“Which storage buckets are connected to my Edge Impulse organization?”
“Does the bucket list expose the secret keys?”
Tell an agent
List the storage buckets of organization {org}.
Show every bucket configured for organization {org}.
POST
/api/organizations/{organizationId}/buckets
Connect an external storage bucket · Add a storage bucket
#
Ask an LLM
“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?”
Tell an agent
Add bucket {bucket} at endpoint {endpoint} in region {region} to organization {org} with access key {access} and secret {secret}.
Connect storage bucket {bucket} to organization {org}, checking connectivity under prefix {prefix}.
POST
/api/organizations/{organizationId}/buckets/verify
Test bucket credentials before connecting · Verify bucket connectivity
#
Ask an LLM
“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?”
Tell an agent
Verify that bucket {bucket} at {endpoint} is reachable with access key {access} for organization {org}.
Test new credentials for bucket {bucket} at endpoint {endpoint} in organization {org} before adding it.
GET
/api/organizations/{organizationId}/buckets/{bucketId}
Get a storage bucket's details · Get storage bucket
#
Ask an LLM
“What endpoint and region is a connected bucket configured with?”
“Can I look up one storage bucket by its ID?”
Tell an agent
Get details of bucket {bucket} in organization {org}.
Show the configuration of storage bucket {bucket} for organization {org}.
POST
/api/organizations/{organizationId}/buckets/{bucketId}
Update a storage bucket's settings · Update storage bucket
#
Ask an LLM
“How do I rotate the access keys on a connected bucket?”
“Do I need to verify connectivity before changing a bucket's credentials?”
Tell an agent
Update bucket {bucket} in organization {org} with access key {access} and secret {secret}.
Change the endpoint of bucket {bucket} in organization {org} to {endpoint}.
DELETE
/api/organizations/{organizationId}/buckets/{bucketId}
Remove a storage bucket · Remove storage bucket
#
Ask an LLM
“What happens to data when I disconnect a storage bucket from my organization?”
“Can I remove a bucket I no longer use?”
Tell an agent destructive · confirm first
Remove storage bucket {bucket} from organization {org}.
Disconnect bucket {bucket} from organization {org}.
POST
/api/organizations/{organizationId}/buckets/{bucketId}/verify
Check access to an already-connected bucket · Verify existing bucket connectivity
#
Ask an LLM
“Is my already-connected bucket still reachable under a given prefix?”
“Can I re-check connectivity on a bucket that's already set up?”
Tell an agent
Verify that existing bucket {bucket} in organization {org} is reachable at prefix {prefix}.
Re-check connectivity of connected bucket {bucket} for organization {org} under {prefix}.
Ask an LLM
“What data items are in my organization's datasets?”
“Can I filter organization data items with a SQL-style WHERE clause?”
Tell an agent
List data items in organization {org}.
List data items in dataset {dataset} of organization {org} matching {filter}.
Ask an LLM
“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?”
Tell an agent
Add a data item named {name} to dataset {dataset} in organization {org} with metadata {metadata}.
Upload files as new data item {name} in dataset {dataset} of organization {org}.
POST
/api/organizations/{organizationId}/data/add-folder
Import bucket folders as data items · Add data items from bucket
#
Ask an LLM
“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?”
Tell an agent
Add every folder under {path} in bucket {bucket} as data items in dataset {dataset} of organization {org}.
Bulk import folders from bucket {bucket} path {path} into dataset {dataset} for organization {org}.
Ask an LLM
“Can I download the data for several selected data items at once?”
“Does a multi-item download query the underlying bucket?”
Tell an agent
Download data items {ids} from organization {org}.
Download the selected items {ids} in dataset {dataset} of organization {org}.
Ask an LLM
“Can I bulk-delete many data items in one call?”
“Will deleting selected data items also remove files from my bucket?”
Tell an agent destructive · confirm first
Delete data items {ids} from organization {org}.
Bulk delete selected items {ids} in dataset {dataset} of organization {org}.
POST
/api/organizations/{organizationId}/data/clear-checklist
Clear checklist flags on data items · Clear checklist for data
#
Ask an LLM
“Can I reset the checklist flags on selected data items?”
“Is there a bulk way to clear checklist status across many items?”
Tell an agent
Clear the checklist flags for data items {ids} in organization {org}.
Reset checklists on items {ids} in dataset {dataset} of organization {org}.
POST
/api/organizations/{organizationId}/data/change-dataset
Move data items to another dataset · Change dataset
#
Ask an LLM
“Can I move a group of data items into a different dataset?”
“Is it possible to reassign selected items to another dataset in bulk?”
Tell an agent
Move data items {ids} in organization {org} to dataset {target}.
Change the dataset of items {ids} in organization {org} to {target}.
Ask an LLM
“Which individual files are included by a data filter across my organization?”
“Can I page through files rather than data items?”
Tell an agent
List files in organization {org} matching filter {filter}.
List the first {limit} files in dataset {dataset} of organization {org}.
POST
/api/organizations/{organizationId}/data/refresh
Refresh data items from buckets · Refresh data
#
Ask an LLM
“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?”
Tell an agent
Refresh dataset {dataset} in organization {org} from its buckets.
Resync data items of dataset {dataset} for organization {org} with S3.
POST
/api/organizations/{organizationId}/data/bulk-metadata
Bulk update metadata from a CSV · Bulk update metadata
#
Ask an LLM
“Can I update metadata for many data items using a CSV file?”
“Which CSV column must identify each item when bulk updating metadata?”
Tell an agent
Bulk update metadata in dataset {dataset} of organization {org} using CSV {csv}.
Apply metadata from a CSV keyed by name to dataset {dataset} in organization {org}.
GET
/api/organizations/{organizationId}/data/{dataId}
Get a data item's metadata · Get data metadata
#
Ask an LLM
“What metadata and files does a specific data item have?”
“Does fetching one data item check the latest file info in the bucket?”
Tell an agent
Get data item {data} in organization {org}.
Show the metadata of data item {data} for organization {org}.
POST
/api/organizations/{organizationId}/data/{dataId}
Update a data item's metadata · Update data metadata
#
Ask an LLM
“Can I rename a single data item or edit its metadata?”
“Is it possible to move one data item to another dataset?”
Tell an agent
Rename data item {data} in organization {org} to {name}.
Set metadata {metadata} on data item {data} in organization {org}.
Ask an LLM
“Can I delete one specific data item?”
“When does removing a single data item also delete it from storage?”
Tell an agent destructive · confirm first
Delete data item {data} from organization {org}.
Remove the single item {data} in organization {org}.
POST
/api/organizations/{organizationId}/data/{dataId}/add
Add files to an existing data item · Add files
#
Ask an LLM
“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?”
Tell an agent
Add files to existing data item {data} in organization {org}.
Attach {files} to data item {data} of organization {org}.
GET
/api/organizations/{organizationId}/data/{dataId}/download
Download all files of one data item · Download data
#
Ask an LLM
“Can I download everything stored in one data item?”
“Is there a single download for all of an item's files?”
Tell an agent
Download all data for data item {data} in organization {org}.
Get every file of item {data} from organization {org} as one download.
DELETE
/api/organizations/{organizationId}/data/{dataId}/download
Delete one file from a data item · Delete file
#
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Delete file {file} from data item {data} in organization {org}.
Remove {file} out of item {data} for organization {org}.
GET
/api/organizations/{organizationId}/data/{dataId}/files/download
Download one file from a data item · Download file
#
Ask an LLM
“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?”
Tell an agent
Download file {file} from data item {data} in organization {org}.
Save {file} from item {data} of organization {org} to disk.
GET
/api/organizations/{organizationId}/data/{dataId}/files/preview
Preview one file from a data item · Preview file
#
Ask an LLM
“Can I view a data item's file inline in the browser instead of downloading it?”
“Might a file preview be truncated?”
Tell an agent
Preview file {file} of data item {data} in organization {org}.
Show an inline preview of {file} from item {data} for organization {org}.
GET
/api/organizations/{organizationId}/data/{dataId}/transformation-jobs
List transformation jobs for a data item · Get transformation jobs for data item
#
Ask an LLM
“Which transformation jobs have processed a given data item?”
“How many transformation jobs come back if I don't pass a limit?”
Tell an agent
List transformation jobs for data item {data} in organization {org}.
Show the last {limit} transformation jobs that ran on item {data} in organization {org}.
Ask an LLM
“How do I create a new research dataset in my organization?”
“Which category, type and bucket must a new dataset specify?”
Tell an agent
Add dataset {dataset} of type {type} and category {category} in bucket {bucket} to organization {org} with tags {tags}.
Create research dataset {dataset} in organization {org}.
GET
/api/organizations/{organizationId}/dataset/{dataset}
Get a dataset's information · Get dataset
#
Ask an LLM
“What type, category and tags does a dataset have?”
“Can I look up one dataset by name?”
Tell an agent
Get information about dataset {dataset} in organization {org}.
Show the settings of dataset {dataset} for organization {org}.
POST
/api/organizations/{organizationId}/dataset/{dataset}
Update a dataset's information · Update dataset
#
Ask an LLM
“Can I retag or recategorize an existing dataset?”
“Is it possible to rename a dataset or change its bucket?”
Tell an agent
Set the tags of dataset {dataset} in organization {org} to {tags}.
Change dataset {dataset}'s category in organization {org} to {category}.
Ask an LLM
“Can I hide a dataset without deleting its data?”
“Does hiding a dataset remove the files underneath?”
Tell an agent
Hide dataset {dataset} in organization {org}.
Hide the {dataset} dataset from organization {org} but keep its data.
POST
/api/organizations/{organizationId}/dataset/{dataset}/upload-link
Create a pre-signed upload link · Create pre-signed S3 upload link
#
Ask an LLM
“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?”
Tell an agent
Create a signed upload link for {file} ({size} bytes, hash {hash}) in dataset {dataset} of organization {org}.
Give me a pre-signed S3 URL to upload {file} into dataset {dataset} for organization {org}.
POST
/api/organizations/{organizationId}/dataset/{dataset}/verify
Verify a dataset is reachable · Verify dataset
#
Ask an LLM
“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?”
Tell an agent
Verify dataset {dataset} in organization {org} is reachable.
Check dataset {dataset} for organization {org} and return some random files.
POST
/api/organizations/{organizationId}/dataset/{dataset}/files
Browse files and folders in a dataset · List files in dataset
#
Ask an LLM
“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?”
Tell an agent
List files and folders under {prefix} in dataset {dataset} of organization {org}.
Show only the folders under {prefix} in dataset {dataset} for organization {org}.
POST
/api/organizations/{organizationId}/dataset/{dataset}/files/delete
Delete a file from a dataset · Delete file from dataset
#
Ask an LLM
“Can I delete a file stored in a dataset by its path?”
“Is removing a file from a dataset by path permanent?”
Tell an agent destructive · confirm first
Delete file {path} from dataset {dataset} in organization {org}.
Remove {path} from the {dataset} dataset of organization {org}.
POST
/api/organizations/{organizationId}/dataset/{dataset}/files/rename
Rename or move a file in a dataset · Rename file from dataset
#
Ask an LLM
“Can I rename a file inside a dataset?”
“Is it possible to move a dataset file to a new path?”
Tell an agent
Rename {old} to {new} in dataset {dataset} of organization {org}.
Move dataset file {old} to {new} within {dataset} for organization {org}.
POST
/api/organizations/{organizationId}/dataset/{dataset}/files/download
Get a signed download URL for a dataset file · Download file from dataset
#
Ask an LLM
“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?”
Tell an agent
Get a signed download URL for {path} in dataset {dataset} of organization {org}.
Download dataset file {path} from {dataset} in organization {org}.
GET
/api/organizations/{organizationId}/dataset/{dataset}/files/download-folder
Download a folder from a dataset · Download folder from dataset
#
Ask an LLM
“Can I download a whole folder from a dataset at once?”
“Are subdirectories included when I download a dataset folder?”
Tell an agent
Download folder {path} from dataset {dataset} in organization {org}.
Grab every file directly inside {path} of dataset {dataset} for organization {org}.
GET
/api/organizations/{organizationId}/dataset/{dataset}/files/view
View a dataset file in the browser · View file from dataset
#
Ask an LLM
“Can I view a Parquet or CSV file from a dataset without downloading it?”
“Will viewing a large CSV in a dataset be truncated?”
Tell an agent
View file {path} in dataset {dataset} of organization {org}.
Open {path} from dataset {dataset} for organization {org} in a readable view.
POST
/api/organizations/{organizationId}/dataset/{dataset}/files/preview
Preview default-dataset files by wildcard · Preview files in a default dataset
#
Ask an LLM
“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?”
Tell an agent
Preview {what} matching {prefix} in default dataset {dataset} of organization {org}.
Show which files match wildcard {prefix} in default dataset {dataset} for organization {org}.
POST
/api/organizations/{organizationId}/buckets/create
Create a bucket in Edge Impulse storage · Create storage bucket
#
Ask an LLM
“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?”
Tell an agent
Create a new Edge Impulse-hosted bucket named {name} for organization {org}.
Provision managed storage bucket {name} in organization {org}.