UpdateUserProfile

Updates an existing user profile.

Allows modification of profile information including display name, profile picture, locale preferences, and currency settings. Only the fields provided in the request will be updated.

Returns the updated UserProfile resource.

Overview

Method Options

Authorisation specification of the UpdateUserProfile method.

Type	METHOD_TYPE_WRITE
Access Level	METHOD_ACCESS_LEVEL_AUTHORISED
Roles	ROLE_IAM_ADMIN ROLE_IAM_USER_PROFILE_ADMIN

Parameters

Request and response parameter message overview:

Input: UpdateUserProfileRequest Message

Field	Type	Required	Description
UserProfile	meshtrade.iam.user_profile.v1.UserProfile	True	The user profile with updated values. The name field must be set to identify which profile to update. Only provided fields will be modified.

Returns: UserProfile Message

Protobuf

syntax = "proto3";

package meshtrade.iam.user_profile.v1;

import "buf/validate/validate.proto";
import "google/protobuf/timestamp.proto";
import "meshtrade/iam/user_profile/v1/user_profile.proto";
import "meshtrade/option/method_options/v1/method_options.proto";

option go_package = "github.com/meshtrade/api/go/iam/user_profile/v1;user_profile_v1";
option java_package = "co.meshtrade.api.iam.user_profile.v1";

/*
   UserProfileService manages user profile information and preferences.

   User profiles contain display preferences, localization settings, and
   personalization data for authenticated users in the IAM system.
   Each profile is linked to a specific user and owned by a group.
*/
service UserProfileService {
  /*
     Updates an existing user profile.

     Allows modification of profile information including display name,
     profile picture, locale preferences, and currency settings.
     Only the fields provided in the request will be updated.

     Returns the updated UserProfile resource.
  */
  rpc UpdateUserProfile(UpdateUserProfileRequest) returns (UserProfile) {
    option (meshtrade.option.method_options.v1.method_options) = {
      type: METHOD_TYPE_WRITE
      access_level: METHOD_ACCESS_LEVEL_AUTHORISED
      roles: [
        ROLE_IAM_ADMIN,
        ROLE_IAM_USER_PROFILE_ADMIN
      ]
    };
  }

  /*
     Retrieves a user profile by its resource name.

     Fetches the complete user profile information including all
     preferences and settings for the specified user profile ID.

     Returns the requested UserProfile resource.
  */
  rpc GetUserProfile(GetUserProfileRequest) returns (UserProfile) {
    option (meshtrade.option.method_options.v1.method_options) = {
      type: METHOD_TYPE_READ
      access_level: METHOD_ACCESS_LEVEL_AUTHORISED
      roles: [
        ROLE_IAM_ADMIN,
        ROLE_IAM_VIEWER,
        ROLE_IAM_USER_PROFILE_ADMIN,
        ROLE_IAM_USER_PROFILE_VIEWER
      ]
    };
  }

  /*
     Retrieves a user profile by the associated user resource name.

     Looks up and returns the user profile linked to a specific user ID.
     This is useful when you have a user resource and need to find
     their associated profile information.

     Returns the UserProfile resource associated with the specified user.
  */
  rpc GetUserProfileByUser(GetUserProfileByUserRequest) returns (UserProfile) {
    option (meshtrade.option.method_options.v1.method_options) = {
      type: METHOD_TYPE_READ
      access_level: METHOD_ACCESS_LEVEL_AUTHORISED
      roles: [
        ROLE_IAM_ADMIN,
        ROLE_IAM_VIEWER,
        ROLE_IAM_USER_PROFILE_ADMIN,
        ROLE_IAM_USER_PROFILE_VIEWER
      ]
    };
  }

  /*
     Lists all user_profiles accessible to the caller.

     Returns a collection of all user_profiles within the caller's
     access scope based on group ownership and role permissions.

     Returns a ListUserProfilesResponse containing all accessible user_profiles.
  */
  rpc ListUserProfiles(ListUserProfilesRequest) returns (ListUserProfilesResponse) {
    option (meshtrade.option.method_options.v1.method_options) = {
      type: METHOD_TYPE_READ
      access_level: METHOD_ACCESS_LEVEL_AUTHORISED
      roles: [
        ROLE_IAM_ADMIN,
        ROLE_IAM_VIEWER,
        ROLE_IAM_USER_PROFILE_ADMIN,
        ROLE_IAM_USER_PROFILE_VIEWER
      ]
    };
  }

  /*
     Retrieves a presigned upload URL for a user profile picture.

     Generates a temporary upload URL that can be used to upload
     a profile picture image. The URL expires after a short duration
     and should be used immediately for uploading the image file.

     Returns upload URL and expiration timestamp.
  */
  rpc GetUserProfilePictureUploadUrl(GetUserProfilePictureUploadUrlRequest) returns (GetUserProfilePictureUploadUrlResponse) {
    option (meshtrade.option.method_options.v1.method_options) = {
      type: METHOD_TYPE_READ
      access_level: METHOD_ACCESS_LEVEL_AUTHORISED
      roles: [
        ROLE_IAM_ADMIN,
        ROLE_IAM_USER_PROFILE_ADMIN
      ]
    };
  }
}

/*
   Request message for GetUserProfileByUser.

   Retrieves a user profile by specifying the associated user resource name.
*/
message GetUserProfileByUserRequest {
  /*
     The resource name of the user whose profile should be retrieved.
     Format: users/{ULIDv2}.
     This field is required.
  */
  string user = 1 [(buf.validate.field) = {
    required: true
    string: {
      min_len: 1
      pattern: "^users/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$"
    }
    cel: {
      id: "user.required"
      message: "user is required and must be in format users/{ULIDv2}"
      expression: "size(this) > 0"
    }
    cel: {
      id: "user.format"
      message: "name must be in format users/{ULIDv2} where ulidv2 is exactly 26 uppercase alphanumeric characters"
      expression: "this.matches('^users/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$')"
    }
  }];
}

/*
   Request message for UpdateUserProfile.

   Updates an existing user profile. Only the fields provided
   in the user_profile will be updated; omitted fields remain unchanged.
*/
message UpdateUserProfileRequest {
  /*
     The user profile with updated values.
     The name field must be set to identify which profile to update.
     Only provided fields will be modified.
  */
  UserProfile user_profile = 1 [(buf.validate.field) = {required: true}];
}

/*
   *
     Request message for GetUserProfile.

     Retrieves a specific user profile by its resource name.
*/
message GetUserProfileRequest {
  /*
     The resource name of the user profile to retrieve.
     Format: iam/user_profiles/{ULIDv2}.
     This field is required.
  */
  string name = 1 [(buf.validate.field) = {
    required: true
    string: {
      min_len: 1
      pattern: "^iam/user_profiles/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$"
    }
    cel: {
      id: "name.required"
      message: "name is required and must be in format iam/user_profiles/{ULIDv2}"
      expression: "size(this) > 0"
    }
    cel: {
      id: "name.format"
      message: "name must be in format iam/user_profiles/{ULIDv2} where ulidv2 is exactly 26 uppercase alphanumeric characters"
      expression: "this.matches('^iam/user_profiles/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$')"
    }
  }];
}

/*
   Request message for ListUserProfiles.

   Lists all user profiles accessible to the caller based on
   their role permissions and group ownership.
*/
message ListUserProfilesRequest {}

/*
   Response message for ListUserProfiles.

   Contains the collection of user profiles accessible to the caller.
*/
message ListUserProfilesResponse {
  /*
     The list of user profiles.
     Ordered by creation time, with most recent first.
  */
  repeated UserProfile user_profiles = 1;
}

/*
   Request message for GetUserProfilePictureUploadUrl.

   Requests a presigned URL for uploading a profile picture for
   the specified user profile.
*/
message GetUserProfilePictureUploadUrlRequest {
  /*
     The resource name of the user profile to upload a picture for.
     Format: iam/user_profiles/{ULIDv2}.
     This field is required.
  */
  string name = 1 [(buf.validate.field) = {
    required: true
    string: {
      min_len: 1
      pattern: "^iam/user_profiles/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$"
    }
    cel: {
      id: "name.required"
      message: "name is required and must be in format iam/user_profiles/{ULIDv2}"
      expression: "size(this) > 0"
    }
    cel: {
      id: "name.format"
      message: "name must be in format iam/user_profiles/{ULIDv2} where ulidv2 is exactly 26 uppercase alphanumeric characters"
      expression: "this.matches('^iam/user_profiles/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$')"
    }
  }];
}

/*
   Response message for GetUserProfilePictureUploadUrl.

   Contains the presigned upload URL and its expiration time.
*/
message GetUserProfilePictureUploadUrlResponse {
  /*
     The presigned URL for uploading the profile picture.
     This URL should be used immediately with a PUT request to upload the image.
  */
  string upload_url = 1;

  /*
     The timestamp when the upload URL expires.
     After this time, the URL will no longer be valid for uploading.
  */
  google.protobuf.Timestamp expires_at = 2;
}

Code Examples

Select supported SDK in the language of your choice for a full example of how to invoke the this method:

Go

package main

import (
	"context"
	"log"

	user_profilev1 "github.com/meshtrade/api/go/iam/user_profile/v1"
)

func main() {
	ctx := context.Background()

	// Default configuration is used and credentials come from MESH_API_CREDENTIALS
	// environment variable or default discovery methods. Zero config required
	// unless you want custom configuration.
	service, err := user_profilev1.NewUserProfileService()
	if err != nil {
		log.Fatalf("Failed to create service: %v", err)
	}
	defer service.Close()

	// Update user profile with modified information
	request := &user_profilev1.UpdateUserProfileRequest{
		UserProfile: &user_profilev1.UserProfile{
			Name:              "iam/user_profiles/${_id}",                       // Existing profile identifier
			Owner:             service.Group(),                                  // Owner must match current ownership
			FirstName:         "Sarah",
			LastName:          "Thompson-Johnson",
			ProfilePictureUrl: "https://cdn.example.com/profiles/sarah-new.jpg", // New photo
		},
	}

	// Call the UpdateUserProfile method
	userProfile, err := service.UpdateUserProfile(ctx, request)
	if err != nil {
		log.Fatalf("UpdateUserProfile failed: %v", err)
	}

	// Use the updated user profile
	log.Printf("User profile updated successfully:")
	log.Printf("  Name: %s", userProfile.Name)
	log.Printf("  First Name: %s", userProfile.FirstName)
	log.Printf("  Last Name: %s", userProfile.LastName)
	log.Printf("User profile information updated with latest details")
}

Python

from meshtrade.api.type.v1.address_pb2 import Address
from meshtrade.api.type.v1.contact_details_pb2 import ContactDetails
from meshtrade.iam.user_profile.v1 import (
    UpdateUserProfileRequest,
    UserProfile,
    UserProfileService,
)


def main():
    # Default configuration is used and credentials come from MESH_API_CREDENTIALS
    # environment variable or default discovery methods. Zero config required
    # unless you want custom configuration.
    service = UserProfileService()

    with service:
        # Update user profile with modified information
        request = UpdateUserProfileRequest(
            user_profile=UserProfile(
                name="user_profiles/01JCXYZ1234567890ABCDEFGHJK",  # Existing profile identifier
                owner=service.group(),  # Owner must match current ownership
                user_name="users/01JCXYZ1234567890ABCDEFGHJK",  # Associated user resource
                first_name="Sarah",
                last_name="Thompson-Johnson",
                profile_picture_url="https://cdn.example.com/profiles/sarah-new.jpg",  # New photo
                address=Address(
                    address_lines=["789 Maple Street", "Suite 2A"],  # New address
                    city="Los Angeles",
                    province="California",
                    country_code="US",
                    postal_code="90001",
                ),
                contact_details=ContactDetails(
                    email_address="sarah.t.johnson@company.com",  # Updated email
                    mobile_number="+14155559999",  # New mobile number
                    phone_number="+14155559876",
                    linkedin="in/sarah-thompson-johnson",  # Updated profile
                    x_twitter="sarahtjohnson",
                ),
            )
        )

        # Call the UpdateUserProfile method
        response = service.update_user_profile(request)
        user_profile = response.user_profile

        # Use the updated user profile
        print("User profile updated successfully:")
        print(f"  Name: {user_profile.name}")
        print(f"  First Name: {user_profile.first_name}")
        print(f"  Last Name: {user_profile.last_name}")
        print(f"  Email: {user_profile.contact_details.email_address}")
        print(f"  Mobile: {user_profile.contact_details.mobile_number}")
        print(f"  City: {user_profile.address.city}")
        print("User profile information updated with latest details")


if __name__ == "__main__":
    main()

Java

import co.meshtrade.api.iam.user_profile.v1.UserProfileService;
import co.meshtrade.api.iam.user_profile.v1.Service.UpdateUserProfileRequest;
import co.meshtrade.api.iam.user_profile.v1.UserProfile.UserProfile;

import java.util.Optional;

public class UpdateUserProfileExample {
    public static void main(String[] args) {
        // Default configuration is used and credentials come from MESH_API_CREDENTIALS
        // environment variable or default discovery methods. Zero config required
        // unless you want custom configuration.
        try (UserProfileService service = new UserProfileService()) {
            // Update user profile with modified information
            UpdateUserProfileRequest request = UpdateUserProfileRequest.newBuilder()
                .setUserProfile(UserProfile.newBuilder()
                    .setName("iam/user_profiles/01JCXYZ1234567890ABCDEFGHJK")  // Existing profile identifier
                    .setOwner(service.getGroup())  // Owner must match current ownership
                    .setUserName("users/01JCXYZ1234567890ABCDEFGHJK")  // Associated user resource
                    .setFirstName("Sarah")
                    .setLastName("Thompson-Johnson")
                    .setProfilePictureUrl("https://cdn.example.com/profiles/sarah-new.jpg")
                    .build())
                .build();

            // Call the UpdateUserProfile method
            UserProfile userProfile = service.updateUserProfile(request, Optional.empty());

            // Use the updated user profile
            System.out.println("User profile updated successfully:");
            System.out.println("  Name: " + userProfile.getName());
            System.out.println("  First Name: " + userProfile.getFirstName());
            System.out.println("  Last Name: " + userProfile.getLastName());
        } catch (Exception e) {
            System.err.println("UpdateUserProfile failed: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Advanced Configuration

For advanced client configuration options (custom endpoints, TLS settings, timeouts), see the SDK Configuration Guide.

Other Methods

• Iam User Profile v1 Method List - For Other methods