---
title: "Updates existing user having given user-id or agent-id."
method: PUT
path: "/group/user"
tags: ["group"]
---

# Updates existing user having given user-id or agent-id.

`PUT /group/user`

Updates existing user information including profile details, permissions, and group assignments. Requires user ID or agent ID to identify the user to modify.

## Request body

- UserDataPut[]
  - `ct_user_id` integer — The unique identifier for the user account
  - `group_id` integer — The group ID to which the user should belong to
  - `agent_id` integer — An external identifier set for user
  - `first_name` string, required — The users first name
  - `last_name` string, required — The users last name
  - `user_email` string, required — The users e-mail address / login
  - `ring_to` integer — The full ring-to number
  - `role` 'Admin' | 'Standard' | 'Read-Only' | 'Identified-only', required — The user account type set for user
  - `user_status` 'active' | 'inactive'
  - `aliases` string — Optional comma separated list of user alias
  - `timezone` 'America/Halifax' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Phoenix' | 'America/Los_Angeles' | 'utc', required — The users timezone

## Response `200`

Updated user details with confirmation status

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)