Skip to main content
GET
/
api
/
v2
/
files
List available documents
curl --request GET \
  --url https://paradigm.lighton.ai/api/v2/files \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "count": 123,
  "next": "https://paradigm.lighton.ai/api/v2/files/?page=4",
  "previous": "https://paradigm.lighton.ai/api/v2/files/?page=2",
  "data": [
    {
      "count": 123,
      "data": [
        {
          "id": 123,
          "object": "<string>",
          "created_at": 123,
          "filename": "<string>",
          "purpose": "<string>",
          "status": "<string>",
          "signature": "<string>"
        }
      ],
      "object": "list",
      "next": "<string>",
      "previous": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
company_scope
boolean

Include documents from the company collection if True.

​
include_details
boolean

Include detail fields (e.g., TLSH signature for duplicate detection). Default: false.

​
page
integer

A page number within the paginated result set.

​
private_scope
boolean

Include documents from the user's private collection if True.

​
tags
string

Comma-separated list of tag IDs to filter by.

​
workspace_scope
integer

Include documents contained in workspace with ID given.

Response

200 - application/json
​
object
string
Example:

"list"

​
count
integer
Example:

123

​
next
string<uri> | null
Example:

"https://paradigm.lighton.ai/api/v2/files/?page=4"

​
previous
string<uri> | null
Example:

"https://paradigm.lighton.ai/api/v2/files/?page=2"

​
data
object[]