← API reference
Query / files

getS3Backend

Fetch one storage backend as an S3 backend. Null when no backend with that id exists in the caller's tenant, or when it exists but is not S3 — a backend has exactly one kind, so asking for the wrong face is a miss rather than an error. Requires storageBackend:read permission.

Arguments

TypeID (sbk_ prefix) of the backend to fetch.

Returns S3Backend

Scalar fields at a glance

endpointString!
regionString!
bucketString!
pathStyleBoolean!
hasCredentialsBoolean!
credentialsUpdatedAtString
↗ View the complete S3Backend type

Explore in a view

Print PrepressProduction Floor
View exact SDL
"""
Fetch one storage backend as an S3 backend. Null when no backend with that id exists in the caller's tenant, or when it exists but is not S3 — a backend has exactly one kind, so asking for the wrong face is a miss rather than an error. Requires storageBackend:read permission.
"""
getS3Backend(
  """TypeID (`sbk_` prefix) of the backend to fetch."""
  id: StorageBackendID!
): S3Backend @topic(names: ["files"])

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