Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
SFTP Storage

Get SFTP storage

Returns details of a specific SFTP storage instance (without credentials).

get/storage/v4/sftp_storages/{storage_id}

Path parameters

storage_idinteger required

Storage ID

Response

SFTPStorageItemV4

addressstring required

Full hostname/address for accessing the storage endpoint

created_atstring date-time required

ISO 8601 timestamp when the storage was created

expiresstring required

Duration when the storage will expire. Null if no expiration is set.

full_namestring required

Read-only internal full name of the storage, composed as "{client_id}-{name}". Used by the SFTP backend as the login username. Clients should use this value when connecting but should continue to identify the storage by name in their own configuration.

has_custom_config_fileboolean required

Whether this storage uses a custom configuration file

has_passwordboolean required

Whether password authentication is configured for this storage

idinteger required

Unique identifier for the storage instance

is_http_disabledboolean required

Whether HTTP access is disabled for this storage (HTTPS only)

location_namestring required

Geographic location code where the storage is provisioned

namestring required

User-defined name for the storage instance, as supplied at creation time.

passwordstring

SFTP password. Only returned when newly generated or set (create/patch). Omitted in GET/list responses.

provisioning_status'creating' | 'active' | 'updating' | 'deleting' | 'deleted' required

Lifecycle status of the storage. Use this to check readiness before operations.

server_aliasstring required

Custom domain alias for accessing the storage. Null if no alias is configured.

ssh_key_idsinteger[] required

IDs of SSH keys associated with this SFTP storage

Example response

{
  "address": "luxembourg-2.storage.example.com",
  "created_at": "2025-08-05T09:17:02Z",
  "expires": "2 years 6 months",
  "full_name": "696-my-sftp-storage",
  "has_password": true,
  "id": 1,
  "location_name": "luxembourg-2",
  "name": "my-sftp-storage",
  "password": "Xy9$mN2p!qR8",
  "provisioning_status": "active",
  "server_alias": "my-storage.example.com",
  "ssh_key_ids": [
    1,
    2
  ]
}