Edit a team user

This function modifies a team user.

SecurityBasicAuth
Request
query Parameters
user
required
string

The username of the team user.

Example: user=teamUser
add_role
string

The role or roles to add to the team user.

Example: add_role=database
email1
string

The primary contact email address to set for the team user.

Example: email1=teamuser@example.com
email2
string

The secondary contact email address to set for the team user.

Example: email2=teamuser@example.com
expire_reason
string

The reason for expiration.

Example: expire_reason=teamUser gave a two week notice.
notes
string

Notes about the new team user. This field should not contain private information.

Example: notes=This is a note about teamUser
password
string

The password to set for the team user.

Example: password=securepassword
remove_role
string

The role or roles to remove from the team user.

Example: remove_role=database
services.email.enabled
integer
Default: 0

Whether to create or remove an email subaccount for the team user. A subaccount is always created for a team user, but it does not have any associated service subaccounts by default.

  • 1 - Create and associate an email subaccount.
  • 0 - Remove any associated email subaccounts.
Enum: 0 1
Example: services.email.enabled=1
services.email.quota
string

The maximum amount of disk space, in megabytes (MB), allocated to the team user's email account.

  • 0 or unlimited - The subaccount has unlimited disk space.

This value defaults to the defined system value.

Note:

This value cannot be larger than the system's maximum email quota.

Example: services.email.quota=500
services.ftp.enabled
integer
Default: 0

Whether to create or remove an FTP subaccount for the team user. A subaccount is always created for a team user, but it does not have any associated service subaccounts by default.

  • 1 - Create and associate an FTP subaccount.
  • 0 - Remove any associated FTP subaccounts.
Enum: 0 1
Example: services.ftp.enabled=1
services.ftp.homedir
string <path>

The team user's FTP home directory, relative to the cPanel account's home directory.

Note:

  • This parameter is required if you enabled the services.ftp.homedir parameter.
  • The directory must exist.
Example: services.ftp.homedir=/Teamusername
services.webdisk.enabled
integer
Default: 0

Whether to create or remove a Web Disk subaccount for the team user. A subaccount is always created for a team user, but it does not have any associated service subaccounts by default.

  • 1 - Create and associate a Web Disk subaccount.
  • 0 - Remove any associated Web Disk subaccounts.
Enum: 0 1
Example: services.webdisk.enabled=1
services.webdisk.enabledigest
integer
Default: 0

Whether to enable the Web Disk Digest Authentication.

  • 1 - Enabled.
  • 0 - Disabled.

Note:

  • Only enable Digest Authentication for clients that require additional compatibility support on certain versions of Windows® operating systems. This compatibility support is only required on servers that use a self-signed certificate for the cpsrvd and cpdavd daemons.
  • We recommend that you do not use Digest Authentication.
Enum: 0 1
Example: services.webdisk.enabledigest=0
services.webdisk.homedir
string <path>

The team user's Web Disk home directory, relative to the cPanel account's home directory.

Note:

This parameter is required if you enable the services.webdisk.enabled parameter.

Example: services.webdisk.homedir=/Teamusername
services.webdisk.perms
string
Default: "rw"

The team user's file permissions for its Web Disk home directory.

  • ro - Read-only permissions.
  • rw - Read and write permissions.

Note:

The services.webdisk.homedir parameter determines the team user's Web Disk home directory.

Example: services.webdisk.perms=rw
services.webdisk.private
integer
Default: 0

Whether to set the directory's permissions to public or private.

  • 1 - Private (0700).
  • 0 - Public (0755).
Enum: 0 1
Example: services.webdisk.private=1
integer or string

The epoch time the team user account expires on or the offset in days.

Examples:
set_expire=120days
set_expire=1649948169
set_role
string

The role or roles to set for the team user.

Example: set_role=email
Responses
200

HTTP Request was successful.

Response Schema: application/json
apiversion
integer

The version of the API.

func
string

The name of the method called.

module
string

The name of the module called.

object
get/Team/edit_team_user
Request samples
uapi --output=jsonpretty \
  --user=username \
  Team \
  edit_team_user \
  user='teamUser'
Response samples
application/json
{
  • "apiversion": 3,
  • "func": "edit_team_user",
  • "module": "Team",
  • "result": {
    • "data": { },
    • "errors": null,
    • "messages": null,
    • "metadata": {
      • "transformed": 1
      },
    • "status": 1,
    • "warnings": null
    }
}