Skip to main content
GET
/
projects
/
{project_reference}
/
uploads
List Uploads
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/uploads \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "type": "folder",
      "path": "<string>",
      "created_at": "<string>"
    }
  ],
  "page_info": {
    "self": "<string>",
    "next": "<string>",
    "prev": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

​
project_reference
string
required

Query Parameters

​
path
string

Folder path prefix to list (e.g., "assets/"). Omit for root.

​
cursor
string

Cursor for pagination (ISO timestamp)

​
limit
number
default:20
Required range: 1 <= x <= 100
​
recursive
boolean
default:true

When true, returns all nested folders under the given path (or all folders if no path). Default: true.

Response

Paginated list of folders and files. Each item has type: "folder" or type: "file".

​
data
object[]
required

Upload item — either a folder (type: "folder") or a file (type: "file")

​
page_info
object
required

Pagination cursor values for traversing the result set.