Update a user

Updates the user information for the given user id.

put

Path parameters

idstringRequired

The id of the user.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

The presentation data transfer object for updating the user.

usernamestring · nullableOptional

The username of the user.

Example: username

emailAddressstring · nullableOptional

The email address of the user.

Example: [e-mail]

nickNamestring · nullableOptional

The nickname of the user.

Example: example

firstNamestring · nullableOptional

The first name of the user.

Example: John

lastNamestring · nullableOptional

The nickname of the user.

Example: Doe

languageCodestring · nullableOptional

The language code of the user. The language code is composed of two parts: the language code and the country code. The language code is a lowercase two-letter code derived from ISO 639-1. The country code is an uppercase two-letter code derived from ISO 3166.

Example: en-US

countryCodestring · nullableOptional

The country code of the user.

timeZoneIdstring · nullableOptional

The id time zone of the user.

phoneNumberstring · nullableOptional

The primary phone number of the user. The phone number is in the E.164 format.

Example: [phone]

avatarstring · uri · nullableOptional

The avatar of the user. The avatar is a URL of the image.

biostring · nullableOptional

The bio is a short description of the user.

Example: example

websitestring · uri · nullableOptional

The website of the user want to update. The website is a URL of the user.

Example: https://mywebsite.com

Responses

200

The request was successful.

application/json

The API result model with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Required

This is the message to be displayed to the user.

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

409

The email address already exists in the system.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

put

/api/v1/users/{id}

HTTPcURLJavaScriptPython

PUT /api/v1/users/{id} HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 313

{
  "username": "exampleuser",
  "emailAddress": "[e-mail]",
  "nickName": "example",
  "firstName": "John",
  "lastName": "Doe",
  "languageCode": "en-US",
  "countryCode": null,
  "timeZoneId": "TimeZone_ID",
  "phoneNumber": "[phone]",
  "avatar": "https://mywebsite.com/avatar.png",
  "bio": "example",
  "website": "https://mywebsite.com"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "id": "sApKpllz4sAplsmzha",
    "brandId": "xZrwkBM58VN",
    "parentUser": {
      "id": "sApKpllz4sAplsmzha",
      "code": "PZBAAE",
      "avatar": "https://www.jframework.io/admin.jpg",
      "packageId": "yDpX0wAbpGRqjv3l",
      "packageCode": "STANDARD",
      "emailAddress": "[e-mail]",
      "phoneNumber": null,
      "nickName": "Admin",
      "roles": [
        "Admin"
      ]
    },
    "code": "AABA24461C0E194BEF3E",
    "username": "john.doe",
    "firstName": "John",
    "lastName": "Doe",
    "nickName": null,
    "avatar": "https://www.johndoe.com/avatar.jpg",
    "emailAddress": "[e-mail]",
    "phoneNumber": "+01234567890",
    "website": "https://www.johndoe.com",
    "bio": null,
    "type": "EndUser",
    "isEmailAddressVerified": false,
    "isUserVerified": false,
    "riskMark": 50,
    "roles": [
      {
        "id": "sApKpllz4sAplsmzha",
        "parentBrandId": "xZrwkBM58VN",
        "guid": "03fd8e47-9d41-4c68-8fea-0a570acec583",
        "code": "SUPER_ADMIN",
        "name": "Super Admin",
        "description": "Super Admin",
        "tags": "#Admin",
        "type": "BuiltIn",
        "permissions": [
          "USER.CREATE"
        ]
      }
    ],
    "referralCode": "AABAAE",
    "testMode": false,
    "tags": null,
    "status": "Active",
    "isSystem": false,
    "package": {
      "id": "sApKpllz4sAplsmzha",
      "code": "CODE",
      "name": "NAME",
      "imageURL": "IMAGE",
      "patternAvatarURL": "https://www.example.com/pattern.jpg",
      "styles": "{\"color\": \"red\"}",
      "description": "DESCRIPTION",
      "tags": "TAGS",
      "isFree": true,
      "tier": 0,
      "zOrder": 1,
      "features": [
        {
          "type": "Function",
          "title": "Feature Title",
          "value": 10,
          "isUnlimited": false,
          "resetPolicy": 0,
          "customIntervalDays": null,
          "id": "sApKpllz4sAplsmzha",
          "parentBrandId": "Brand_ID",
          "eventId": "Event_ID",
          "code": "Code",
          "name": "Feature Name",
          "unit": "Unit",
          "defaultValue": null,
          "helpURL": null,
          "image": "https://www.example.com/image.jpg",
          "styles": "{\"color\": \"red\"}",
          "description": "Feature Description",
          "tags": "#Tag1, #Tag2",
          "zOrder": 1,
          "status": "Active"
        }
      ],
      "prices": [
        {
          "id": "sApKpllz4sAplsmzha",
          "code": "Code",
          "name": "Name",
          "amount": 10,
          "currency": "USD",
          "description": "Description",
          "checkoutLink": "CheckoutLink",
          "tags": "Tags",
          "packageName": "PackageName",
          "packageId": "PackageId",
          "subscriptionName": "SubscriptionName",
          "subscriptionTypeId": "SubscriptionTypeId",
          "zOrder": 1
        }
      ],
      "isDefault": true,
      "status": "Inactive"
    },
    "packageId": "yDpX0wAbpGRqjv3l",
    "languageCode": "en-US",
    "countryCode": "US",
    "timeZoneId": "QlzwLjGaKvAvbD5x",
    "expiryDate": "2026-02-25T01:03:23.9241Z",
    "themeStyle": "light",
    "enableSignInDetection": true,
    "isUserIntegration": false,
    "createdDate": "2026-01-26T01:03:23.924101Z"
  },
  "errors": []
}