List uploads - Veryfront

listUploads(input: ListUploadsInput!): UploadsConnection!

Files are paginated; visible folders are returned separately and are unpaginated. Continue using pageInfo.endCursor while hasNextPage is true, including empty visible pages.

Arguments

Argument	Type	Required
`input`	`ListUploadsInput!`	Yes

Input fields

input

ListUploadsInput

Field	Type	Required	Description
`projectReference`	`String`	No	Project ID
`projectId`	`ID`	No	Deprecated: Use projectReference.
`cursor`	`String`	No	Opaque continuation returned in pageInfo.endCursor; copy unchanged with the same project/path/sort. Removed anchors require restarting; live changes can affect traversal. Legacy timestamp inputs retain creation cutoff semantics and cannot recover ties. Follow hasNextPage even when visibility filtering leaves data empty.
`limit`	`Int`	No	Number of files scanned per page before visibility filtering (default: 20, max: 100). The returned page can contain fewer visible files.
`path`	`String`	No	Folder path prefix; supplied paths select direct-child files. Omit to list all project files.
`recursive`	`Boolean`	No	Expand nested folders (default true). This controls folder output, not file recursion.
`sortBy`	`UploadSortField`	No	Sort field: created_at (default), name or size; file IDs break ties.
`sortOrder`	`UploadSortOrder`	No	Sort direction: asc or desc (default).

Response

Returns UploadsConnection!. Open the type for its fields and nested types.

Field	Type	Description
`data`	`[UploadedFile!]!`	Visible uploaded files in this page. Folder entries are not included.
`folders`	`[UploadFolder!]!`	Visible folders, separate from the file cursor and page limit.
`pageInfo`	`PageInfo!`	Pagination info

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

query ListUploads($input: ListUploadsInput!) {
  listUploads(input: $input) {
    data {
      id
      name
      status
      createdAt
      updatedAt
    }
    folders {
      createdAt
      path
      permission
      visibility
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}

{
  "input": {
    "projectReference": "00000000-0000-4000-8000-000000000001"
  }
}