Skip to content

FTP-SSH

All operations require authentication.

10 operationsv1/hosting/web
Agent setup

List independent usersProduction

GET
/1.0/hosting/web/{serviceName}/indy

List independent users. Returns the logins of the independent multidomain users of the hosting. Filter them by login.

Path parameters

serviceName
required
string

The internal name of your hosting

Query parameters

login
string

Filter the value of login property (like)

Response

200string[]successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/indy \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get an independent userProduction

GET
/1.0/hosting/web/{serviceName}/indy/{login}

Get an independent user. Returns the home directory, state and attached domains of the independent multidomain user.

Path parameters

login
required
string

Login of the multidomain independent user

serviceName
required
string

The internal name of your hosting

Response

200indysuccessful operation
attachedDomains
read-only
string[]

AttachedDomain IDs linked to this multidomain

home
read-only
string

Home directory

login
read-only
string

Login of the multidomain independent user

state
read-only
StateEnum

User status

Valuesoffrw

Example uses login = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/indy/{login} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "attachedDomains": [ "string" ], "home": "string", "login": "string", "state": "off"}

Get the SSH public keyProduction

GET
/1.0/hosting/web/{serviceName}/key/ssh

Returns the SSH public key of the hosting.

Path parameters

serviceName
required
string

Service name

Response

200Keysuccessful operation
publicKey
read-only
string

Public key

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/key/ssh \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "publicKey": "string"}

List usersProduction

GET
/1.0/hosting/web/{serviceName}/user

List users. Returns the logins of the FTP and SSH users of the hosting. Filter them by home or login.

Path parameters

serviceName
required
string

The internal name of your hosting

Query parameters

home
string

Filter the value of home property (like)

login
string

Filter the value of login property (like)

Response

200string[]successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get a userProduction

GET
/1.0/hosting/web/{serviceName}/user/{login}

Get a user. Returns the home directory, SSH state, state and status of the user, and whether it is the primary account.

Path parameters

login
required
string

Login used to connect on FTP and SSH

serviceName
required
string

The internal name of your hosting

Response

200usersuccessful operation
home
string

Home directory

isPrimaryAccount
read-only
boolean

Is this user primary

login
read-only
string

Login used to connect on FTP and SSH

serviceManagementCredentials
read-only
ServiceCredentials

Credentials to manage your webhosting

sshState
SshStateEnum

User ssh status

Valuesactivenonesftponly
state
StateEnum

User state

Valuesoffrw
status
read-only
StatusEnum

The user status

Valuescreatedcreatingdeletingupdating
taskId
read-only
integer

The task ID working on this user

Example uses login = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user/{login} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "home": "string", "isPrimaryAccount": true, "login": "string", "serviceManagementCredentials": { "ftp": { "port": 0, "url": "string", "user": "string" }, "ssh": { "port": 0, "url": "string", "user": "string" } }, "sshState": "active", "state": "off", "status": "created", "taskId": 0}

Generate an SSH key pairProduction

POST
/1.0/hosting/web/{serviceName}/key/ssh

Generates an SSH key pair for the hosting and returns its public key.

Path parameters

serviceName
required
string

Service name

Response

200Keysuccessful operation
publicKey
read-only
string

Public key

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/key/ssh \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "publicKey": "string"}

Create a userProduction

POST
/1.0/hosting/web/{serviceName}/user

Create a user. Creates an FTP and SSH user with a login, a password and a home directory, and returns the task. sshState is none by default.

Path parameters

serviceName
required
string

The internal name of your hosting

Request body (required)

home
required
string

Home directory

login
required
string

Login use for your new user

password
required
stringpassword

Password

sshState
SshStateEnum

Ssh state for this user. Default: none

Valuesactivenonesftponly

Response

200tasksuccessful operation
doneDate
read-only
stringdate-time

Completion date

function
read-only
string

Function name

id
read-only
integer

the id of the task

lastUpdate
read-only
stringdate-time

last update

objectId
read-only
string

Task related object ID

objectType
read-only
ObjectTypeEnum

Task object type

ValuesAbuseAttachedDomainBlockedIpCdnCronDatabaseDumpEnvVarFilerzHostedsslHostingIndyInfraMinorModuleOtherOvhConfigOvhOrgOwnLogsRuntimeScanSqlpersoUserUserLogsWebWebd
startDate
read-only
stringdate-time

Task Creation date

status
read-only
StatusEnum

Task status

Valuescancelleddoingdoneerrorinittodo

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "objectId": "string", "objectType": "Abuse", "startDate": "2024-01-01T12:00:00Z", "status": "cancelled"}

Change a user passwordDeprecated

POST
/1.0/hosting/web/{serviceName}/user/{login}/changePassword

Deprecated since Aug 31, 2026, will be removed on Oct 31, 2026 — use /hosting/web/{serviceName}/user/{login} instead.

Change a user password. Changes the password of the user and returns the task. The password is used for both FTP and SSH access.

Path parameters

login
required
string

Login used to connect on FTP and SSH

serviceName
required
string

The internal name of your hosting

Request body (required)

password
required
stringpassword

The user's new password

Response

200tasksuccessful operation
doneDate
read-only
stringdate-time

Completion date

function
read-only
string

Function name

id
read-only
integer

the id of the task

lastUpdate
read-only
stringdate-time

last update

objectId
read-only
string

Task related object ID

objectType
read-only
ObjectTypeEnum

Task object type

ValuesAbuseAttachedDomainBlockedIpCdnCronDatabaseDumpEnvVarFilerzHostedsslHostingIndyInfraMinorModuleOtherOvhConfigOvhOrgOwnLogsRuntimeScanSqlpersoUserUserLogsWebWebd
startDate
read-only
stringdate-time

Task Creation date

status
read-only
StatusEnum

Task status

Valuescancelleddoingdoneerrorinittodo

Example uses login = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user/{login}/changePassword \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "objectId": "string", "objectType": "Abuse", "startDate": "2024-01-01T12:00:00Z", "status": "cancelled"}

Delete a userProduction

DELETE
/1.0/hosting/web/{serviceName}/user/{login}

Delete a user. Permanently deletes the user and returns the task. The files in its home folder are kept.

Path parameters

login
required
string

Login used to connect on FTP and SSH

serviceName
required
string

The internal name of your hosting

Response

200tasksuccessful operation
doneDate
read-only
stringdate-time

Completion date

function
read-only
string

Function name

id
read-only
integer

the id of the task

lastUpdate
read-only
stringdate-time

last update

objectId
read-only
string

Task related object ID

objectType
read-only
ObjectTypeEnum

Task object type

ValuesAbuseAttachedDomainBlockedIpCdnCronDatabaseDumpEnvVarFilerzHostedsslHostingIndyInfraMinorModuleOtherOvhConfigOvhOrgOwnLogsRuntimeScanSqlpersoUserUserLogsWebWebd
startDate
read-only
stringdate-time

Task Creation date

status
read-only
StatusEnum

Task status

Valuescancelleddoingdoneerrorinittodo

Example uses login = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user/{login} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "objectId": "string", "objectType": "Abuse", "startDate": "2024-01-01T12:00:00Z", "status": "cancelled"}

Update a userProduction

PUT
/1.0/hosting/web/{serviceName}/user/{login}

Update a user. Updates the home directory, SSH state or state of the user. Set state to off to disable the FTP and SSH access of the user.

Path parameters

login
required
string

Login used to connect on FTP and SSH

serviceName
required
string

The internal name of your hosting

Request body (required)

home
string

Home directory

isPrimaryAccount
read-only
boolean

Is this user primary

login
read-only
string

Login used to connect on FTP and SSH

serviceManagementCredentials
read-only
ServiceCredentials

Credentials to manage your webhosting

sshState
SshStateEnum

User ssh status

Valuesactivenonesftponly
state
StateEnum

User state

Valuesoffrw
status
read-only
StatusEnum

The user status

Valuescreatedcreatingdeletingupdating
taskId
read-only
integer

The task ID working on this user

Response

200—successful operation

Example uses login = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/hosting/web/{serviceName}/user/{login} \
  -H "authorization: Bearer $OVH_TOKEN"