PATCH /api/v2/users/{id}

The user's id. ('me' can be used if you are using a user level API key)

Default value: "application/json"

[single-line only]

The user's job title.

Whether or not the user is enabled to dial internationally.

A list of phone numbers that should be dialed in addition to the user's Dialpad number(s) upon receiving a call.

The user's license type.

Changing this affects billing for the user. For a Sell license, specify the type as agents. For a Support license, specify the type as support.

Possible values:

• "dpde_all"
• "lite_lines"
• "lite_support_agents"
• "talk"
• "admins"
• "agents"
• "dpde_one"
• "magenta_lines"

A list of the phone number(s) assigned to this user.

This can be used to re-order or remove numbers. To assign a new number, use the assign number API instead.

[single-line only]

The user's first name.

The user's new extension number.

Extensions are optional in Dialpad and turned off by default. If you want extensions please contact support to enable them.

The user's emails.

This can be used to add, remove, or re-order emails. The first email in the list is the user's primary email.

The user's state.

This is used to suspend or re-activate a user.

Possible values:

• "active"
• "suspended"

The list of admin office IDs.

This is used to set the user as an office admin for the offices with the provided IDs.

[single-line only]

The user's last name.

Whether or not the user is a super admin. (company level administrator)

Whether or not to keep phone numbers when switching to a support license.

Note: Phone numbers require additional number licenses under a support license.

Default value: true

The user's office id.

If provided, the user will be moved to this office. For international offices, the user must not have phone numbers assigned. Once the transfer is complete, your admin can add the phone numbers via the user assign number API. Only supported on paid accounts and there must be enough licenses to transfer the user to the destination office.

The provider requesting the presence status update.

The presence status message to be updated.

Predefined templates will be only used for the supported types.

Accepts the following types:

• default -- status message template: "{provider}: {message}"
• conference -- status message template: "On {provider}: in the {message} meeting"

provider and message should be chosen with the message template in mind.

Possible values:

• "conference"
• "default"