Update a User

Update the properties of a specified ACS user

Updates any of the following properties of a specified ACS user:

• full_name

• email_address

• phone_number

• access_schedule

/acs/users/update

post

Updates the properties of a specified access system user.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

Body

acs_user_idstring · uuidOptional

ID of the access system user that you want to update. You can only provide acs_user_id or user_identity_id.

user_identity_idstring · uuidOptional

ID of the user identity that you want to update. You can only provide acs_user_id or user_identity_id. If you provide user_identity_id, you must also provide acs_system_id.

acs_system_idstring · uuidOptional

ID of the access system that you want to update. You can only provide acs_system_id with user_identity_id.

full_namestring · min: 1Optional

Full name of the access system user.

emailstring · emailOptionalDeprecated

phone_numberstringOptional

Phone number of the access system user in E.164 format (for example, [phone]).

email_addressstring · emailOptional

Email address of the access system user.

hid_acs_system_idstring · uuidOptional

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /acs/users/update HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer API Key
Content-Type: application/json
Accept: */*
Content-Length: 396

{
  "access_schedule": {
    "starts_at": "2025-07-01T04:59:27.119Z",
    "ends_at": "2025-07-01T04:59:27.119Z"
  },
  "acs_user_id": "123e4567-e89b-12d3-a456-426614174000",
  "user_identity_id": "123e4567-e89b-12d3-a456-426614174000",
  "acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
  "full_name": "text",
  "phone_number": "text",
  "email_address": "[email protected]",
  "hid_acs_system_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "ok": true
}

Request

Specify the desired ACS user by including the corresponding acs_user_id in the request body. In addition, in the request body, include the properties that you want to update, along with the desired replacement values.

Request Body Parameters

Parameter	Type	Description
acs_user_id	String (UUID) Required	ID of the desired ACS user
full_name	String Optional	Replacement full name for the ACS user
email_address	String Optional	Replacement email address for the ACS user
phone_number	String Optional	Replacement phone number for the ACS user in E.164 format (for example, [phone])
access_schedule	Object Optional	Replacement starts_at and ends_at dates/times for the ACS user's access

Sample Request

Python

seam.acs.users.update(
  acs_user_id="33333333-3333-3333-3333-333333333333",
  full_name="Jack Doe",
  email_address="[email protected]",
  phone_number="[phone]",
  access_schedule={
    "starts_at": "2024-04-01T10:40:00Z",
    "ends_at": "2024-04-04T10:40:00Z"
  }
)

cURL (bash)

curl -X 'POST' \
  "https://connect.getseam.com/acs/users/update" \
  -H 'accept: application/json' \
  -H "Authorization: Bearer ${API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
  "acs_user_id": "33333333-3333-3333-3333-333333333333",
  "full_name": "Jack Doe",
  "email_address": "[email protected]",
  "phone_number": "[phone]",
  "access_schedule": {
    "starts_at": "2024-04-01T10:40:00Z",
    "ends_at": "2024-04-04T10:40:00Z"
  }
}'

JavaScript

await seam.acs.users.update({
  acs_user_id: "33333333-3333-3333-3333-333333333333",
  full_name: "Jack Doe",
  email_address: "[email protected]",
  phone_number: "[phone]",
  access_schedule: {
    "starts_at": "2024-04-01T10:40:00Z",
    "ends_at": "2024-04-04T10:40:00Z"
  }
});

Ruby

# Coming soon!

PHP

$seam->acs->users->update(
  acs_user_id: "33333333-3333-3333-3333-333333333333",
  full_name: "Jack Doe",
  email_address: "[email protected]",
  phone_number: "[phone]",
  access_schedule: array(
    "starts_at" => "2024-04-01T10:40:00Z",
    "ends_at" => "2024-04-04T10:40:00Z"
  )
);

C#

seam.UsersAcs.Update(
  acsUserId: "33333333-3333-3333-3333-333333333333",
  fullName: "Jack Doe",
  emailAddress: "[email protected]",
  phoneNumber: "[phone]",
  accessSchedule: new Dictionary<string, string>()
    {
      {"starts_at", "2024-04-01T10:40:00Z"},
      {"ends_at", "2024-04-04T10:40:00Z"}
    }
);

Java

// Coming soon!

Go

startsAt, err := time.Parse(time.RFC3339, "2024-04-01T10:40:00Z")
endsAt, err := time.Parse(time.RFC3339, "2024-04-04T10:40:00Z")
if err != nil {
  return err
}

acs_user, uErr := client.Acs.Users.Update(
  context.Background(), &acs.UsersUpdateRequest{
    AcsUserId: "33333333-3333-3333-3333-333333333333",
    FullName: api.String("Jack Doe"),
    EmailAddress: api.String("[email protected]"),
    PhoneNumber: api.String("[phone]"),
    AccessSchedule: &acs.UsersCreateRequestAccessSchedule{
      StartsAt: startsAt,
      EndsAt: endsAt,
    },
  },
)

Response

Returns a Boolean ok status indicator or void.

Sample Response

Python

None

cURL (bash)

{
  "ok": true
}

JavaScript

void

Ruby

# Coming soon!

PHP

void

C#

void

Java

// Coming soon!

Go

{
  "acs_user": {
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "display_name": "Jack Doe",
    "full_name": "Jack Doe",
    "email": "[email protected]",
    "email_address": "[email protected]",
    "phone_number": "[phone]",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2024-04-02T09:53:26.421Z",
    "is_suspended": false,
    "user_identity_id": "22222222-2222-2222-2222-222222222222"
  },
  "ok": true
}