Project files list
GET /admin/projects/{projectId}/files
List files uploaded to a project. Returns file metadata including name, type, size, URL, thumbnail, and uploader. Filter by file type, uploader, date range, or search by name.
Send Accept: text/csv to get a streaming CSV export of the filtered result set instead of JSON. The CSV path honors every filter on this endpoint, ignores cursor, and applies limit if explicit (default 100,000, hard cap 100,000). Short-lived signed URLs are omitted.
Authorization
bearer In: header
Path Parameters
Project ID
Query Parameters
Pagination cursor
Max rows in this response. JSON: 1–50 (default 25), paginate via cursor. CSV (Accept: text/csv): 1–100,000 (default 100,000 — the cap).
Sort field: createdAt, name, size (default: createdAt)
Sort direction (default: desc)
"asc" | "desc"Filter by file MIME type (comma-separated, e.g. "application/pdf,image/png")
Filter by file class: specVersion (spec PDFs), drawingVersion (drawing PDFs), uncategorized (everything else)
"specVersion" | "drawingVersion" | "uncategorized"Filter to files uploaded by this user ID
Search by file name (case-insensitive)
length <= 500ISO date — only files created after this date
ISO date — only files created before this date
Response Body
application/json
application/json
curl -X GET "https://api.part3.io/v1/admin/projects/string/files"{
"data": [
{
"uid": "file_2a3b4c5d6e",
"name": "A-201 — Curtain Wall Details.pdf",
"type": "application/pdf",
"size": 4837192,
"url": "https://storage.googleapis.com/part3-files/proj_5f9a3c2e8b/file_2a3b4c5d6e.pdf",
"thumbnailUrl": "https://storage.googleapis.com/part3-files/proj_5f9a3c2e8b/file_2a3b4c5d6e_thumb.png",
"fileClass": "uncategorized",
"createdBy": "user_99a8b7c6d5",
"createdByName": "Jane Smith",
"createdAt": "2026-04-21T15:32:00Z"
}
],
"nextCursor": "eyJzIjoiMjAyNi0wNC0yMVQxNTozMjowMFoiLCJpZCI6ImZpbGVfMmEifQ",
"hasMore": true,
"total": 312
}{
"error": "limit must be a positive integer"
}{
"error": "Insufficient permissions"
}