API Reference
Users Management
Edit User

User Management – Edit User

Update an existing organization user. Requires a valid Bearer token.

Authentication

Include the token in the Authorization header:

Authorization: Bearer <YOUR_AUTH_TOKEN>

Endpoint

PUThttps://api.samvyo.com/api/user/orgUser

Required Headers

Content-Type: application/json
Authorization: Bearer <YOUR_AUTH_TOKEN>

Request Body

{
  "admin": true,
  "displayRating": true,
  "email": "user@example.com",
  "location": "New York",
  "meetNowEnabled": true,
  "name": "John Doe",
  "tags": ["sales", "customer success"],
  "userId": "<USER_ID>"
}

Field Reference

Required

  • userId: The unique identifier of the user to edit.

Optional (fields to update)

  • email: New email for the user. Must be unique.
  • name: New name for the user.
  • location: Location string.
  • admin: Toggle admin access for this user; default is false.
  • meetNowEnabled: Allow participation in MeetNow meetings; default is false.
  • tags: Labels to identify the user (used in MeetNow contexts).
  • displayRating: Enable showing MeetNow ratings for this user.

Example Requests

JavaScript (fetch)

const res = await fetch('https://api.samvyo.com/api/user/orgUser', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${authToken}`
  },
  body: JSON.stringify({
    admin: true,
    displayRating: true,
    email: 'user@example.com',
    location: 'New York',
    meetNowEnabled: true,
    name: 'John Doe',
    tags: ['sales', 'customer success'],
    userId: '<USER_ID>'
  })
});
const data = await res.json();

cURL

curl -X PUT \
  'https://api.samvyo.com/api/user/orgUser' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_AUTH_TOKEN>' \
  -d '{
    "admin": true,
    "displayRating": true,
    "email": "user@example.com",
    "location": "New York",
    "meetNowEnabled": true,
    "name": "John Doe",
    "tags": ["sales", "customer success"],
    "userId": "<USER_ID>"
  }'

Success Response

{
  "success": true,
  "user": {
    "id": "<USER_ID>",
    "email": "user@example.com",
    "name": "John Doe",
    "createdAt": "2025-08-06T02:15:33.750Z",
    "location": "New York",
    "username": "john_doe_123",
    "role": "moderator",
    "accountSuspended": false,
    "accountDeleted": false,
    "displayRating": true,
    "meetNowEnabled": true,
    "tags": ["sales", "customer success"],
    "admin": true
  }
}

Failure Responses

Missing userId

{
  "success": false,
  "message": "userId is required to edit a user."
}

Email already exists

{
  "success": false,
  "message": "Email already exists. Try again with a different email."
}
Create UserFetch Users