List Files

List files in organization’s storage.

• Supports path filtering
• Pagination with limit/offset
• Sorting options

GET /api/v1/storage/files

List Files

cURL

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/storage/files \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "<string>",
    "file_name": "<string>",
    "file_path": "<string>",
    "content_type": "<string>",
    "file_size_bytes": 123,
    "checksum": "<string>",
    "uploaded_by": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "last_accessed_at": "<string>",
    "access_count": 123,
    "provider": "<string>",
    "tags": [
      "<string>"
    ],
    "custom_metadata": {}
  }
]

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Query Parameters

path_prefix · string | null

Filter by path prefix

limit · integer · default: 100

Maximum files to return

Required range: 1 <= x <= 1000

offset · integer · default: 0

Pagination offset

Required range: x >= 0

sort_by · string · default: created_at

Pattern: ^(created_at|file_name|file_size_bytes)$

sort_order · string · default: desc

Pattern: ^(asc|desc)$

Response

200

application/json

Successful Response

id · string · required

file_name · string · required

file_path · string · required

content_type · string · required

file_size_bytes · integer · required

checksum · string | null · required

uploaded_by · string · required

created_at · string · required

updated_at · string · required

last_accessed_at · string | null · required

access_count · integer · required

provider · string · required

tags · string[]

custom_metadata · Custom Metadata · object