← API reference
Mutation / files

testFolder

Checks a folder transport with a read-only stat probe. CONTROL_CLOUD reports UNKNOWN because its sentinel probe cannot verify tenant storage provisioning or remote reachability. Other bindings accept an absent sentinel as reachable; this does not test write permissions. Nothing is written, and no folder state changes. Requires folder:read permission.

Arguments

TypeID of the folder to probe (e.g. "fld_01K…").

Returns FolderProbeResult!

Scalar fields at a glance

okBoolean!
errorString
↗ View the complete FolderProbeResult type

Explore in a view

Print PrepressProduction Floor
View exact SDL
"""
Checks a folder transport with a read-only stat probe. CONTROL_CLOUD reports UNKNOWN because its sentinel probe cannot verify tenant storage provisioning or remote reachability. Other bindings accept an absent sentinel as reachable; this does not test write permissions. Nothing is written, and no folder state changes. Requires folder:read permission.
"""
testFolder(
  """TypeID of the folder to probe (e.g. "fld_01K…")."""
  id: FolderID!
): FolderProbeResult! @topic(names: ["files"])

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