List files

List files

get

Lists all files included by the filter.

Authorizations
Path parameters
organizationIdintegerRequired

Organization ID

Query parameters
datasetstringOptional

Selected dataset

Example: activity data
filterstringOptional

Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).

Example: dataset = 'activity data' AND (label = 'running' OR metadata->user = 'Jan Jongboom')
limitintegerOptional

Maximum number of results

offsetintegerOptional

Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.

Responses
200
OK
application/json
Responseall of
get
GET /v1/api/organizations/{organizationId}/data/files HTTP/1.1
Host: studio.edgeimpulse.com
x-api-key: YOUR_API_KEY
Accept: */*
200

OK

{
  "success": true,
  "error": "text",
  "filterParseError": "text",
  "totalFileSize": 1,
  "totalFileCount": 1,
  "totalDataItemCount": 1,
  "data": [
    {
      "id": 1,
      "name": "text",
      "bucketId": 1,
      "bucketName": "text",
      "bucketPath": "text",
      "dataset": "text",
      "totalFileCount": 1,
      "totalFileSize": 1,
      "created": "2025-07-03T20:01:25.338Z",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "files": [
        {
          "name": "text",
          "bucketPath": "text",
          "size": 1,
          "lastModified": "2025-07-03T20:01:25.338Z"
        }
      ]
    }
  ]
}

Last updated

Was this helpful?