Skip to main content
GET
/
data-sources
List all data sources
curl --request GET \
  --url https://apigcp.trynia.ai/v2/data-sources \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "url": "<string>",
    "file_name": "<string>",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "page_count": 0,
    "chunk_count": 0,
    "project_id": "<string>",
    "source_type": "web",
    "is_active": true,
    "display_name": "<string>",
    "arxiv_id": "<string>",
    "paper_source": "<string>",
    "metadata": {},
    "error": "<string>",
    "error_code": "<string>",
    "category_id": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header

Query Parameters

​
q
string

Optional substring filter (matches display_name/url/file_name)

​
status
string

Optional status filter (e.g. completed|indexing|failed)

​
source_type
string

Optional source type filter (e.g. web|documentation|research_paper|text)

​
category_id
string

Optional category filter. Use 'uncategorized' for sources without category

​
limit
integer
default:100

Max data sources to return (db-level pagination)

Required range: 1 <= x <= 500
​
offset
integer
default:0

Number of data sources to skip (db-level pagination)

Required range: x >= 0

Response

List of data sources retrieved successfully

​
id
string

Unique identifier for the data source

​
url
string

The indexed URL

​
file_name
string

File name for text sources

​
status
enum<string>

Current indexing status

Available options:
pending,
processing,
completed,
failed,
error
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
page_count
integer
default:0

Number of pages indexed

​
chunk_count
integer
default:0

Number of chunks/embeddings created

​
project_id
string

Associated project ID if any

​
source_type
enum<string>
default:web
Available options:
web,
documentation,
research_paper,
text
​
is_active
boolean
default:true
​
display_name
string

Custom display name for the data source

​
arxiv_id
string | null

arXiv identifier when source_type is research_paper

​
paper_source
string | null

Research paper source provider (e.g. arxiv)

​
metadata
object

Optional lightweight metadata. For research_paper sources this may include title/authors/etc. For other source types this may be omitted.

​
error
string

Error message if status is 'error' or 'failed'

​
error_code
string

Error code for programmatic error handling

​
category_id
string | null

Optional category ID for organizing data sources