Skip to main content
POST
/
storage
/
provisioning
/
v3
/
storages
/
sftp
Create SFTP storage
curl --request POST \
  --url https://api.gcore.com/storage/provisioning/v3/storages/sftp \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_name": "mia",
  "name": "my-sftp-storage",
  "generate_sftp_password": true,
  "sftp_password": "MySecurePassword123"
}
'
{
  "address": "mia.origin.gcdn.co",
  "created_at": "2025-08-05 09:17:02.095832+00:00",
  "credentials": {
    "sftp_password": "Xy9$mN2p!qR8",
    "ssh_keys": [
      {
        "created_at": "2025-08-05 09:15:00+00:00",
        "id": 123,
        "name": "my-production-key",
        "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAA... user@example.com"
      }
    ]
  },
  "id": 1,
  "location_name": "mia",
  "name": "my-sftp-storage",
  "provisioning_status": "ok",
  "custom_config_file": false,
  "disable_http": false,
  "expires": "2 years 6 months",
  "server_alias": "my-storage.example.com"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Body

application/json
​
location_name
string
required

Location code where the storage should be created

Example:

"mia"

​
name
string
required

User-defined name for the storage instance

Example:

"my-sftp-storage"

​
generate_sftp_password
boolean

Generate a random SFTP password

Example:

true

​
sftp_password
string

Optional password for SFTP access

Example:

"MySecurePassword123"

Response

SFTPStorageResV3

SFTPStorageResV3 response for SFTP storage V3

​
address
string
required

Full hostname/address for accessing the storage endpoint

Example:

"mia.origin.gcdn.co"

​
created_at
string
required

ISO 8601 timestamp when the storage was created

Example:

"2025-08-05 09:17:02.095832+00:00"

​
credentials
object
required

SFTPCredentialsV3 credentials for SFTP storage V3

​
id
integer<int64>
required

Unique identifier for the storage instance

Example:

1

​
location_name
string
required

Geographic location code where the storage is provisioned

Example:

"mia"

​
name
string
required

User-defined name for the storage instance

Example:

"my-sftp-storage"

​
provisioning_status
enum<string>
required

Current provisioning status of the storage instance

Available options:
creating,
ok,
updating,
deleting,
deleted
Example:

"ok"

​
custom_config_file
boolean

Whether custom configuration file is used for this storage

Example:

false

​
disable_http
boolean

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

Example:

false

​
expires
string

Duration when the storage will expire (if set)

Example:

"2 years 6 months"

​
server_alias
string

Custom domain alias for accessing the storage

Example:

"my-storage.example.com"