DUduda
Native booking staff members api

Update staff member

Partially updates a staff member: only the fields present in the request are changed, and any field omitted keeps its current value. The linked Duda account can be switched to a different one through account_name, but it cannot be removed - this API has no way to turn an account-linked staff member back into a standalone one.

put/api/sites/multiscreen/{site_name}/booking/staff-members/{id}

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/booking/staff-members/{id}
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

idstring required

Request body

account_namestring nullable

Name of a Duda account that will be associated with the staff member. For more information about accounts, see: https://developer.duda.co/reference/accounts-object. This is a partial update - only fields provided in the request will be updated. If provided, the account must exist and not be already associated with another staff member in this organization. If omitted or set to null, the account association remains unchanged. Note: Removing account association is not supported through this API - the account association can only be changed to a different account, not removed.

emailstring nullable

Email address of the staff member. This is a partial update - only fields provided in the request will be updated. If provided, must be a valid email address format and cannot be empty or blank. If omitted, the email remains unchanged.

namestring nullable

Full name of the staff member. This is a partial update - only fields provided in the request will be updated. If provided, cannot be empty or blank. If omitted, the name remains unchanged.

Example request

{
  "account_name": "example-account",
  "email": "john.doe@multiscreensite.com",
  "name": "John Doe"
}

Response

OK

account_namestring nullable

Name of the Duda account associated with the staff member. For more information about accounts, see: https://developer.duda.co/reference/accounts-object. Null if the staff member is not associated with any account.

emailstring required

Email address of the staff member

idstring required

Unique identifier for the staff member

namestring required

Full name of the staff member

Example response

{
  "account_name": "example-account",
  "email": "john.doe@multiscreensite.com",
  "id": "staff-member-123",
  "name": "John Doe"
}

Changes

No recorded changes to this operation across all 1 revision of this API.