← API reference
CANONICAL TYPE REFERENCE

StorageBackendConnectionStatus

Whether a backend's stored credentials are currently usable. CONNECTED means the backend can be used for transfers; NEEDS_REAUTHORIZATION means an OAuth consent flow must be (re)completed — it covers both a draft backend awaiting its first authorization and a live one whose refresh token was revoked or expired. Non-OAuth backends (S3, host-path, FTP) are always CONNECTED.

CONNECTED

The backend's stored credentials are usable, so it can serve transfers. Non-OAuth backends (S3, host-path, FTP) never report anything else.

NEEDS_REAUTHORIZATION

An OAuth consent flow has to be run before the backend can be used. Covers both a draft backend still awaiting its first authorization and a live one whose refresh token was revoked or expired; reauthorizationReason says which, when a reason was recorded.

View exact SDL
"""
Whether a backend's stored credentials are currently usable. CONNECTED means the backend can be used for transfers; NEEDS_REAUTHORIZATION means an OAuth consent flow must be (re)completed — it covers both a draft backend awaiting its first authorization and a live one whose refresh token was revoked or expired. Non-OAuth backends (S3, host-path, FTP) are always CONNECTED.
"""
enum StorageBackendConnectionStatus {
  """
  The backend's stored credentials are usable, so it can serve transfers. Non-OAuth backends (S3, host-path, FTP) never report anything else.
  """
  CONNECTED
  """
  An OAuth consent flow has to be run before the backend can be used. Covers both a draft backend still awaiting its first authorization and a live one whose refresh token was revoked or expired; reauthorizationReason says which, when a reason was recorded.
  """
  NEEDS_REAUTHORIZATION
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.