List uploads

uploads(input: UploadsInput!): UploadList!

Requires project.uploads.read.

Arguments

ArgumentTypeRequired
inputUploadsInput!Yes

Input fields

input

UploadsInput

FieldTypeRequiredDescription
projectReferenceString!YesProject UUID, slug or configured domain.
pathStringNoFolder prefix; a supplied path selects its direct-child uploads. Omit it to list the whole project.
recursiveBooleanNoExpand nested folders in folders (default true). It does not change which uploads are listed.
sortByUploadSortByNoSort field: created_at (default), name or size_bytes. Ties break by upload ID ascending.
sortOrderUploadSortOrderNoSort direction: asc or desc (default).
cursorStringNopageInfo.endCursor of the previous page; send it unchanged with the same path and sort.
limitIntNoUploads scanned per page before visibility filtering (default 20, max 100).

Response

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

FieldTypeDescription
data[Upload!]!Visible uploads of this page.
folders[UploadFolder!]!Visible folders. They are separate from the upload cursor and not limited by the page size.
pageInfoPageInfo!Continue from endCursor while hasNextPage is true, even when data is empty.

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

Example

graphql
query Uploads($input: UploadsInput!) {
  uploads(input: $input) {
    data {
      id
      status
      createdAt
      updatedAt
      contentType
    }
    folders {
      createdAt
      path
      permission
      visibility
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "input": {
    "projectReference": "00000000-0000-4000-8000-000000000001"
  }
}