Archust Docs
Documents

List documents (paginated)

tRPC `documents.list` — `protectedProcedure`. Cache 60s qua `tenantKey`. Yêu cầu tenant member.

GET
/v1/documents

Authorization

bearerAuth
AuthorizationBearer <token>

Clerk session JWT. Also send x-clerk-org-id if org context needed.

In: header

Query Parameters

status?string

Value in

  • "all"
  • "pending"
  • "processing"
  • "ready"
  • "error"
search?string
Lengthlength <= 255
fileType?string
Default"all"

Value in

  • "all"
  • "pdf"
  • "docx"
  • "txt"
  • "md"
  • "url"
source?string
Default"all"

Value in

  • "all"
  • "upload"
  • "website_scan"
sortBy?string
Default"created_at"

Value in

  • "created_at"
  • "filename"
sortOrder?string
Default"desc"

Value in

  • "asc"
  • "desc"
limit?integer
Range1 <= value <= 100
Default50
offset?integer
Range0 <= value <= 100000
Default0

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/documents"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "filename": "string",      "file_type": "pdf",      "storage_path": "string",      "source_metadata": {        "knowledge": {          "isPrimary": true,          "description": "string",          "tags": [            "string"          ],          "language": "string"        }      },      "status": "pending",      "chunk_count": 0,      "document_version": 1,      "created_at": "2019-08-24T14:15:22Z",      "knowledge": {},      "usage": {        "jobs": [          {            "id": "string",            "name": "string"          }        ],        "generationCount": 0,        "lastUsedAt": "2019-08-24T14:15:22Z"      }    }  ],  "total": 0}