Skip to main content
POST
/
api
/
v1
/
storage
/
files
/
search
Search Files
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/storage/files/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "tags": [
    "<string>"
  ],
  "path_prefix": "<string>",
  "content_type": "<string>",
  "min_size": 123,
  "max_size": 123,
  "uploaded_by": "<string>"
}
'
[
  {
    "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

Body

application/json

File search request

query
string | null
tags
string[] | null
path_prefix
string | null
content_type
string | null
min_size
integer | null
max_size
integer | null
uploaded_by
string | null

Response

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