Files
Upload and manage knowledge files
Live API testing
Paste a tq_live_… key from Settings → API Keys. Requests are sent through this docs server to /api/v1/… (no browser CORS). The key is kept in sessionStorage only.
Base URL: https://api.taliiq.com — set $TALIIQ_API_KEY to a key from Settings → API Keys in the dashboard.
List files
GET
/api/v1/files/files.list · scope: files:readcurl -X GET 'https://api.taliiq.com/api/v1/files/?limit=20&cursor=' \
-H 'Authorization: Bearer $TALIIQ_API_KEY'import requests
url = "https://api.taliiq.com/api/v1/files/?limit=20&cursor="
headers = {
"Authorization": "Bearer $TALIIQ_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())const response = await fetch("https://api.taliiq.com/api/v1/files/?limit=20&cursor=", {
method: "GET",
headers: {
"Authorization": "Bearer $TALIIQ_API_KEY"
},
});
console.log(await response.json());Try it live
/api/proxy/v1/files/?limit=20&cursor=Upload file
POST
/api/v1/files/files.upload · scope: files:writeMultipart upload. The file is indexed asynchronously; status becomes available when processing completes.
curl -X POST 'https://api.taliiq.com/api/v1/files/' \
-H 'Authorization: Bearer $TALIIQ_API_KEY' \
-F 'file=@/path/to/document.pdf'import requests
url = "https://api.taliiq.com/api/v1/files/"
headers = {k: v for k, v in {"Authorization":"Bearer $TALIIQ_API_KEY"}.items() if k != "Content-Type"}
with open("/path/to/document.pdf", "rb") as f:
response = requests.post(
url,
headers=headers,
files={"file": f},
data={"name": "My Document"},
)
print(response.status_code)
print(response.json())const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("name", "My Document");
const response = await fetch("https://api.taliiq.com/api/v1/files/", {
method: "POST",
headers: {
Authorization: "Bearer $TALIIQ_API_KEY",
},
body: form,
});
console.log(await response.json());Try it live
/api/proxy/v1/files/Get file
GET
/api/v1/files/{file_id}files.get · scope: files:readcurl -X GET 'https://api.taliiq.com/api/v1/files/{file_id}/' \
-H 'Authorization: Bearer $TALIIQ_API_KEY'import requests
url = "https://api.taliiq.com/api/v1/files/{file_id}/"
headers = {
"Authorization": "Bearer $TALIIQ_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())const response = await fetch("https://api.taliiq.com/api/v1/files/{file_id}/", {
method: "GET",
headers: {
"Authorization": "Bearer $TALIIQ_API_KEY"
},
});
console.log(await response.json());Try it live
/api/proxy/v1/files/{id}/Delete file
DELETE
/api/v1/files/{file_id}files.delete · scope: files:writeClear knowledge_file on agents using this file first. Returns 409 resource_in_use if attached.
curl -X DELETE 'https://api.taliiq.com/api/v1/files/{file_id}/' \
-H 'Authorization: Bearer $TALIIQ_API_KEY'import requests
url = "https://api.taliiq.com/api/v1/files/{file_id}/"
headers = {
"Authorization": "Bearer $TALIIQ_API_KEY"
}
response = requests.delete(url, headers=headers)
print(response.status_code)
print(response.json())const response = await fetch("https://api.taliiq.com/api/v1/files/{file_id}/", {
method: "DELETE",
headers: {
"Authorization": "Bearer $TALIIQ_API_KEY"
},
});
console.log(await response.json());Try it live
/api/proxy/v1/files/{id}/