List Files
curl --request GET \
--url https://api.example.com/api/files \
--header 'Authorization: <authorization>'import requests
url = "https://api.example.com/api/files"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.example.com/api/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/files"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/files")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"files": [
{
"id": "<string>",
"filename": "<string>",
"path": "<string>",
"user_id": "<string>",
"meta": {
"name": "<string>",
"content_type": "<string>",
"size": 123
},
"data": {
"status": "<string>",
"content": "<string>"
},
"created_at": 123,
"updated_at": 123
}
]
}Files & Media
List Files
GET
/
api
/
files
List Files
curl --request GET \
--url https://api.example.com/api/files \
--header 'Authorization: <authorization>'import requests
url = "https://api.example.com/api/files"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.example.com/api/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/files"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/files")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"files": [
{
"id": "<string>",
"filename": "<string>",
"path": "<string>",
"user_id": "<string>",
"meta": {
"name": "<string>",
"content_type": "<string>",
"size": 123
},
"data": {
"status": "<string>",
"content": "<string>"
},
"created_at": 123,
"updated_at": 123
}
]
}Retrieve a list of files accessible to the authenticated user. Admin users with bypass access control enabled can see all files.
Request
Headers
string
required
Bearer token for authentication
Query Parameters
boolean
default:"true"
Whether to include extracted content in the response. Set to
false to reduce response size.Response
Returns an array of file objects.array
string
Unique identifier for the file
string
Original filename
string
Storage path of the file
string
ID of the user who uploaded the file
object
number
Unix timestamp of when the file was created
number
Unix timestamp of when the file was last updated
Examples
List all files with content
curl https://your-domain.com/api/files \
-H "Authorization: Bearer YOUR_TOKEN"
Response
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"filename": "document.pdf",
"path": "550e8400-e29b-41d4-a716-446655440000_document.pdf",
"user_id": "user123",
"meta": {
"name": "document.pdf",
"content_type": "application/pdf",
"size": 153600
},
"data": {
"status": "completed",
"content": "This is the extracted text from the PDF..."
},
"created_at": 1709856000,
"updated_at": 1709856100
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"filename": "recording.mp3",
"path": "660e8400-e29b-41d4-a716-446655440001_recording.mp3",
"user_id": "user123",
"meta": {
"name": "recording.mp3",
"content_type": "audio/mpeg",
"size": 2048000
},
"data": {
"status": "completed",
"content": "Transcribed audio content..."
},
"created_at": 1709857000,
"updated_at": 1709857200
}
]
List files without content
curl https://your-domain.com/api/files?content=false \
-H "Authorization: Bearer YOUR_TOKEN"
Response
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"filename": "document.pdf",
"path": "550e8400-e29b-41d4-a716-446655440000_document.pdf",
"user_id": "user123",
"meta": {
"name": "document.pdf",
"content_type": "application/pdf",
"size": 153600
},
"data": {
"status": "completed"
},
"created_at": 1709856000,
"updated_at": 1709856100
}
]
Search Files
To search for files by filename pattern, use the search endpoint:GET /api/files/search?filename=*.pdf&skip=0&limit=50