โ† API reference
Query / files

folders

Folders in the caller's tenant, filtered and sorted, as a connection. Requires folder:list permission.

Arguments

firstInt

Page size, 0 to 100 (default 25). A value outside that range returns a PAGE_SIZE_NEGATIVE or PAGE_SIZE_EXCEEDED error.

afterString

Cursor from a previous page's edge (a folder TypeID) to continue after. The listing resumes at the folder following that cursor, under the same filter and sort. A cursor that matches no folder in the result set is ignored and the first page is returned.

Narrow the result set by name and/or binding kind. Omit to list every folder in the tenant.

Sort keys; only the first is applied. Defaults to creation time, newest first, when omitted.

Returns FolderConnection!

Scalar fields at a glance

totalCountInt
โ†— View the complete FolderConnection type

Explore in a view

Print PrepressProduction Floor
View exact SDL
"""
Folders in the caller's tenant, filtered and sorted, as a connection. Requires folder:list permission.
"""
folders(
  """
  Page size, 0 to 100 (default 25). A value outside that range returns a PAGE_SIZE_NEGATIVE or PAGE_SIZE_EXCEEDED error.
  """
  first: Int
  """
  Cursor from a previous page's edge (a folder TypeID) to continue after. The listing resumes at the folder following that cursor, under the same `filter` and `sort`. A cursor that matches no folder in the result set is ignored and the first page is returned.
  """
  after: String
  """
  Narrow the result set by name and/or binding kind. Omit to list every folder in the tenant.
  """
  filter: FolderFilterInput
  """
  Sort keys; only the first is applied. Defaults to creation time, newest first, when omitted.
  """
  sort: [FolderSortInput!]
): FolderConnection! @topic(names: ["files"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.