Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
Retrieve a paginated list of files uploaded to an organization.
GEThttps://api.freddy.aitronos.com/v1/organizations/{organization_id}/files

List all files uploaded to an organization with optional filtering and pagination.

Path Parameters

organization_id string required

The unique identifier of the organization.

Query Parameters

page integer optional · Defaults to 1

Page number for pagination (1-indexed).

pageSize integer optional · Defaults to 20

Number of items per page (max 100).

purpose string optional

Filter by file purpose (e.g., vector_store, user_upload).

search string optional

Search query to filter files by filename.


Returns

A paginated list of File objects.

Bash
curl "https://api.freddy.aitronos.com/v1/organizations/org_abc123/files?page=1&pageSize=20" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response

{
  "data": [
    {
      "id": "file_abc123",
      "name": "product_docs.pdf",
      "organizationId": "org_abc123",
      "size": 2457600,
      "mimeType": "application/pdf",
      "purpose": "vector_store",
      "status": "uploaded",
      "createdAt": "2025-01-20T15:30:00Z",
      "createdBy": "uid_user123"
    },
    {
      "id": "file_def456",
      "name": "customer_data.csv",
      "organizationId": "org_abc123",
      "size": 524288,
      "mimeType": "text/csv",
      "purpose": "vector_store",
      "status": "uploaded",
      "createdAt": "2025-01-19T10:15:00Z",
      "createdBy": "uid_user456"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20
}