You can use the additional SFTP users endpoint to:
- Enable or disable additional SFTP accounts.
- Add additional SFTP accounts.
- Get a list of additional SFTP accounts.
- Remove additional SFTP accounts.
You can obtain the environment_id using the GET request with the WordPress Site Environments endpoint.
The environment_id is also shown after the site_id in the URL in MyKinsta when you access the environment, for example in the URL https://my.kinsta.com/sites/details/fbab4927-e354-4044-b226-29ac0fbd20ca/c84ce214-69b9-4a32-8e67-880672cf1d38?idCompany=bdd25d71-5706-4890-870f-1adda17c505d:
- The
site_idisfbab4927-e354-4044-b226-29ac0fbd20ca - The
environment_idisc84ce214-69b9-4a32-8e67-880672cf1d38 - The
company_idisbdd25d71-5706-4890-870f-1adda17c505d
The sftp_account_id is shown when you GET the list of additional SFTP users.
Enable or disable additional SFTP accounts
Toggling status for additional SFTP accounts in progress
No or invalid API key provided to the request
Error occurred while trying to toggle status for additional SFTP accounts
- Payload
- curl
- Node.js
- Browser JavaScript
- PHP
{- "enabled": true
}- 202
- 401
- 500
{- "operation_id": "sftp-accounts:toggle-status-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "message": "Updating Additional SFTP Accounts Status in progress",
- "status": 202
}Add additional SFTP account
Adding additional SFTP account successful
No or invalid API key provided to the request
Error occurred while trying to add additional SFTP account
- Payload
- curl
- Node.js
- Browser JavaScript
- PHP
{- "username": "test-user",
- "password": "R8zXwT@#bV!kJq9^",
- "root_directory": "/dir_1",
- "permission": "write"
}- 200
- 401
- 500
{- "operation_id": "sftp-accounts:add-additional-sftp-account-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "message": "Adding Additional SFTP Account in progress",
- "status": 202
}Get list of additional SFTP accounts
Successfully found additional SFTP accounts
No or invalid API key provided to the request
Could not find the additional SFTP accounts or the user does not have permissions to retrieve data
Error occurred while retrieving additional SFTP accounts
- curl
- Node.js
- Browser JavaScript
- PHP
- 200
- 401
- 404
- 500
{- "environment": {
- "additional_sftp_accounts": [
- {
- "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "username": "test-user",
- "root_directory": "/",
- "is_active": true,
- "permission": "write"
}
]
}
}Remove additional SFTP account
Removing additional SFTP account in progress
No or invalid API key provided to the request
Error occurred while trying to remove additional SFTP account
- curl
- Node.js
- Browser JavaScript
- PHP
- 202
- 401
- 500
{- "operation_id": "sftp-accounts:remove-additional-sftp-account-54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "message": "Removing Additional SFTP Account in progress",
- "status": 202
}