v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-29251563.8 KB
sftp-credentials

Create SFTP credentials

post/headless/sftp/credentials/

Request body

hostnamestring required
portinteger required
userstring required
auth_type'PASSWORD' | 'KEY' required
passwordstring

Required when auth_type is PASSWORD

private_keystring

Required when auth_type is KEY (OpenSSH format)

Example request

{
  "hostname": "sftp.example.com",
  "port": 22,
  "user": "sftpuser",
  "auth_type": "PASSWORD",
  "password": "secure-password-123",
  "private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\nb3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAABlwAAAAdzc2gtcn\n...\n-----END OPENSSH PRIVATE KEY-----"
}

Response

SFTP credentials created

idstring uuid
hostnamestring required
portinteger required
userstring required
auth_type'PASSWORD' | 'KEY' required
key_fingerprintstring nullable

Example response

{
  "id": "ee5d0e45-b098-47bc-8217-e93790243dfa",
  "hostname": "sftp.example.com",
  "port": 22,
  "user": "sftpuser",
  "auth_type": "PASSWORD",
  "key_fingerprint": "SHA256:abc123..."
}