Logo
Search
Docs

List files

GET https://app.sulus.ai/api/v1/agents/{agent_id}/files

List an agent's knowledge files

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Path parameters

agent_id string Required

The agent id (UUID).

Validation: uuid (route-constrained)
Stored in ai_projects.uid

Errors

StatusMeaningBody
404 Agent not found, or you do not have access to it
401 Missing or invalid bearer token
403 Feature ai_chat not enabled for the account

Notes

  • extractable/indexed reflect whether the extension supports text extraction and whether it currently has search vectors; pdf/doc/docx/rtf are stored for reference but not text-extracted.
curl --request GET \
  --url https://app.sulus.ai/api/v1/agents/{agent_id}/files \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
import requests

url = "https://app.sulus.ai/api/v1/agents/{agent_id}/files"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}

response = requests.get(url, headers=headers)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://app.sulus.ai/api/v1/agents/{agent_id}/files"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
Response 200 
{
    "object": "list",
    "data": [
        {
            "id": 51,
            "project_id": 7,
            "original_name": "faq.md",
            "mime": "text/markdown",
            "size": 6120,
            "created_at": "2026-07-28T10:05:22.000000Z",
            "extractable": true,
            "vector_count": 12,
            "indexed": true,
            "url": "/storage/ai-projects/7/files/9f8e7d6c-0000-4000-8000-000000000020.md",
            "preview_kind": "text"
        },
        {
            "id": 52,
            "project_id": 7,
            "original_name": "pricing-sheet.pdf",
            "mime": "application/pdf",
            "size": 184320,
            "created_at": "2026-07-29T16:41:09.000000Z",
            "extractable": false,
            "vector_count": 0,
            "indexed": false,
            "url": "/storage/ai-projects/7/files/a1b0c9d8-0000-4000-8000-000000000021.pdf",
            "preview_kind": "pdf"
        }
    ]
}