This page lists all HTTP APIs for user profiles, such as updating user descriptions and retrieving badges. Legacy APIs Legacy APIs with cookie authentication can incorporate breaking changes without notice. We don't recommend them for production applications. Account information v1 Base URLhttps://accountinformation.roblox.comPOST/v1/descriptionUpdate the user's descriptionGET/v1/descriptionGet the user's descriptionGET/v1/metadataGet the metadataGET/v1/promotion-channelsGet the user's promotion channelsGET/v1/users/{userId}/promotion-channelsGet promotion channels for a given user IDGET/v1/users/{userId}/roblox-badgesReturns a list of Roblox badges belonging to a user.GET/v1/xbox-live/consecutive-login-daysReturns number of consecutive login days for xbox usersModelsModels Roblox.AccountInformation.Api.Models.BirthdateRequest Roblox.AccountInformation.Api.Models.BirthdateResponse Roblox.AccountInformation.Api.Models.ConsecutiveLoginDaysResponse Roblox.AccountInformation.Api.Models.DescriptionRequest Roblox.AccountInformation.Api.Models.DescriptionResponse Roblox.AccountInformation.Api.Models.EmptyRequest Roblox.AccountInformation.Api.Models.GenderRequest Roblox.AccountInformation.Api.Models.GenderResponse Roblox.AccountInformation.Api.Models.MetadataResponse Roblox.AccountInformation.Api.Models.PhoneRequest Roblox.AccountInformation.Api.Models.PhoneResponse Roblox.AccountInformation.Api.Models.PromotionChannelsByUserIdResponse Roblox.AccountInformation.Api.Models.PromotionChannelsRequest Roblox.AccountInformation.Api.Models.PromotionChannelsResponse Roblox.AccountInformation.Api.Models.StarCodeAffiliateRequest Roblox.AccountInformation.Api.Models.StarCodeAffiliateResponse Roblox.AccountInformation.Api.Models.VerifyEmailRequest Roblox.AccountInformation.Api.Models.VerifyEmailResponse Roblox.AccountInformation.Api.Models.VerifyPhoneRequest Roblox.AccountInformation.Api.RobloxBadgeResponse Roblox.Platform.UserPhoneNumberVerification.Models.PendingVerificationResponse Roblox.Web.WebAPI.ApiEmptyResponseModel View all endpoints for Account information v1 Avatar v1 Base URLhttps://avatar.roblox.comPOST/v1/avatar/redraw-thumbnailRequests the authenticated user's thumbnail be redrawnGET/v1/users/{userId}/avatarReturns details about a specified user's avatarGET/v1/users/{userId}/currently-wearingGets a list of asset ids that the user is currently wearingModelsModels Roblox.Api.Avatar.Controllers.V1.AvatarController.EmptyResponse Roblox.Api.Avatar.Models.AssetIdListModel Roblox.Api.Avatar.Models.AssetMetaModelV1 Roblox.Api.Avatar.Models.AssetModelV2 Roblox.Api.Avatar.Models.AssetTypeModel Roblox.Api.Avatar.Models.AssetTypeRulesModel Roblox.Api.Avatar.Models.AvatarApiSuccessResponse Roblox.Api.Avatar.Models.AvatarFilteredPageResponse[Roblox.Api.Avatar.Models.OutfitModel] Roblox.Api.Avatar.Models.AvatarMetadataModel Roblox.Api.Avatar.Models.AvatarModelV2 Roblox.Api.Avatar.Models.AvatarRulesModel Roblox.Api.Avatar.Models.BodyColorModel Roblox.Api.Avatar.Models.BodyColorsModel Roblox.Api.Avatar.Models.DefaultClothingAssets Roblox.Api.Avatar.Models.EmoteResponseModel Roblox.Api.Avatar.Models.GameStartInfoResponse Roblox.Api.Avatar.Models.OutfitDetailsModel Roblox.Api.Avatar.Models.OutfitModel Roblox.Api.Avatar.Models.PlayerAvatarTypeModel Roblox.Api.Avatar.Models.RecentItemModel Roblox.Api.Avatar.Models.ScaleRulesModel Roblox.Api.Avatar.Models.UniverseAvatarAssetOverrideResponseModel Roblox.Api.Avatar.Models.WearResponseModel Roblox.Avatarcore.Common.Models.AccessoryPositionModel Roblox.Avatarcore.Common.Models.AccessoryRefinementModel Roblox.Avatarcore.Common.Models.AccessoryRotationModel Roblox.Avatarcore.Common.Models.AccessoryScaleModel Roblox.Avatarcore.Shared.V3.AssetPosition Roblox.Avatarcore.Shared.V3.AssetRotation Roblox.Avatarcore.Shared.V3.AssetScale Roblox.Web.Responses.Avatar.ScaleModel Roblox.Web.WebAPI.Models.ApiLegacyPageResponse[Roblox.Api.Avatar.Models.RecentItemModel] View all endpoints for Avatar v1 Badges v1 Base URLhttps://badges.roblox.comGET/v1/users/{userId}/badgesGets a list of badges a user has been awarded.ModelsModels Roblox.Badges.Api.BadgeAwardResponse Roblox.Badges.Api.BadgeCreatorResponse Roblox.Badges.Api.BadgeMetadataResponse Roblox.Badges.Api.BadgeResponse Roblox.Badges.Api.GetBadgesByUserResponse Roblox.Badges.Api.UniverseResponse Roblox.Badges.Api.UpdateBadgeRequest Roblox.Paging.ExclusiveStartKeyCursor[System.String] Roblox.Web.Responses.Badges.BadgeAwardStatisticsResponse Roblox.Web.Responses.Badges.BadgeResponseV2 Roblox.Web.Responses.RelatedEntityTypeResponse[Roblox.Platform.Badges.BadgeAwarderType] Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Badges.Api.BadgeAwardResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Badges.Api.BadgeResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Badges.Api.GetBadgesByUserResponse] Roblox.Web.WebApi.FormData.IUploadedFile System.IO.Stream View all endpoints for Badges v1 Groups v1 Base URLhttps://groups.roblox.comPOST/v1/user/groups/primarySets the authenticated user's primary groupDELETE/v1/user/groups/primaryRemoves the authenticated user's primary groupGET/v1/users/{userId}/groups/primary/roleGets a user's primary group.ModelsModels Roblox.Groups.Api.ChangeOwnerRequest Roblox.Groups.Api.CreateWallPostRequest Roblox.Groups.Api.GroupAllRolesResponse Roblox.Groups.Api.GroupAuditLogPageResponse[Roblox.Groups.Api.Models.Response.GroupAuditLogResponseItem] Roblox.Groups.Api.GroupConfigurationDisplayOptionsResponse Roblox.Groups.Api.GroupConfigurationResponse Roblox.Groups.Api.GroupDescriptionResponse Roblox.Groups.Api.GroupDetailResponse Roblox.Groups.Api.GroupEconomyPermissionsModel Roblox.Groups.Api.GroupForumsPermissionsModel Roblox.Groups.Api.GroupJoinRequestResponse Roblox.Groups.Api.GroupManagementPermissionsModel Roblox.Groups.Api.GroupMembershipDetailResponse Roblox.Groups.Api.GroupMembershipMetadataResponse Roblox.Groups.Api.GroupMembershipPermissionsModel Roblox.Groups.Api.GroupNameChangeConfigurationResponse Roblox.Groups.Api.GroupNotificationPreferenceData Roblox.Groups.Api.GroupOpenCloudPermissionsModel Roblox.Groups.Api.GroupPayoutResponse Roblox.Groups.Api.GroupPayoutRestrictionResponse Roblox.Groups.Api.GroupPermissionsModel Roblox.Groups.Api.GroupPermissionsResponse Roblox.Groups.Api.GroupPoliciesResponse Roblox.Groups.Api.GroupPolicyRequest Roblox.Groups.Api.GroupPolicyResponse Roblox.Groups.Api.GroupPostsPermissionsModel Roblox.Groups.Api.GroupRelationshipsResponse Roblox.Groups.Api.GroupRoleDetailResponse Roblox.Groups.Api.GroupRoleResponse Roblox.Groups.Api.GroupSearchMetadataResponse Roblox.Groups.Api.GroupSearchPageResponse Roblox.Groups.Api.GroupSearchResponseItem Roblox.Groups.Api.GroupSettingsResponse Roblox.Groups.Api.GroupsDisplayOptionsResponse Roblox.Groups.Api.JoinGroupRequest Roblox.Groups.Api.MembersRequest Roblox.Groups.Api.Models.Request.CreateRoleSetRequest Roblox.Groups.Api.Models.Request.UpdateRoleSetRequest Roblox.Groups.Api.Models.Response.GroupAuditLogResponseItem Roblox.Groups.Api.Models.Response.GroupNameHistoryResponseItem Roblox.Groups.Api.Models.Response.GroupWallPostModel Roblox.Groups.Api.Models.Response.UserModel Roblox.Groups.Api.PayoutRecipientRequest Roblox.Groups.Api.PayoutRequest Roblox.Groups.Api.PostGroupStatusRequest Roblox.Groups.Api.PrimaryGroupRequest Roblox.Groups.Api.RecurringPayoutsConfigurationResponse Roblox.Groups.Api.RelationshipsRequest Roblox.Groups.Api.RoleConfigurationResponse Roblox.Groups.Api.ShoutResponse Roblox.Groups.Api.SocialLinkRequest Roblox.Groups.Api.SocialLinkResponse Roblox.Groups.Api.UpdateGroupDescriptionRequest Roblox.Groups.Api.UpdateGroupNameRequest Roblox.Groups.Api.UpdateGroupNameResponse Roblox.Groups.Api.UpdateGroupNotificationPreferenceRequest Roblox.Groups.Api.UpdateGroupSettingsRequest Roblox.Groups.Api.UpdatePermissionsRequest Roblox.Groups.Api.UpdateUserRoleRequest Roblox.Groups.Api.UserGroupMembershipResponse Roblox.Groups.Api.UserGroupRoleResponse Roblox.Groups.Client.GroupFeaturedContentResponse Roblox.Paging.ExclusiveStartKeyCursor[System.String] Roblox.Paging.StartIndexCursor Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int32] Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int64] Roblox.Web.Responses.Groups.GroupBasicResponse Roblox.Web.Responses.Groups.GroupResponseV2 Roblox.Web.Responses.RelatedEntityTypeResponse[Roblox.Web.Responses.Groups.GroupOwnerType] Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int32] Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupMembershipDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupPayoutResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupPermissionsResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupRoleDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.SocialLinkResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.UserGroupMembershipResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Web.Responses.Groups.GroupBasicResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.GroupJoinRequestResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.GroupNameHistoryResponseItem] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.GroupWallPostModel] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.UserModel] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.UserGroupRoleResponse] Roblox.Web.WebApi.FormData.IUploadedFile System.IO.Stream System.ValueTuple[Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64],Roblox.Paging.ExclusiveStartKeyCursor[System.String]] View all endpoints for Groups v1 Premium features v1 Base URLhttps://premiumfeatures.roblox.comGET/v1/users/{userId}/premium-upsell-precheckPremium upsell precheckGET/v1/users/{userId}/validate-membershipGet if a user has a Premium membershipView all endpoints for Premium features v1 Presence v1 Base URLhttps://presence.roblox.comPOST/v1/presence/usersGet Presence for a list of usersModelsModels Roblox.Presence.Api.Models.Request.UserPresenceRequest Roblox.Presence.Api.Models.Response.UserPresence Roblox.Presence.Api.Models.Response.UserPresencesResponse View all endpoints for Presence v1 Users v1 Base URLhttps://users.roblox.comGET/v1/descriptionGet the user's descriptionGET/v1/users/{userId}Gets detailed user information by id.PATCH/v1/users/{userId}/display-namesSet the display name for the authorized user.GET/v1/users/{userId}/username-historyRetrieves the username history for a particular user.ModelsModels Roblox.Paging.ExclusiveStartKeyCursor[System.Nullable[System.Int64]] Roblox.Paging.StartIndexCursor Roblox.Users.Api.AuthenticatedGetUserResponse Roblox.Users.Api.BirthdateRequest Roblox.Users.Api.BirthdateResponse Roblox.Users.Api.DescriptionRequest Roblox.Users.Api.DescriptionResponse Roblox.Users.Api.GenderRequest Roblox.Users.Api.GenderResponse Roblox.Users.Api.GetUserResponse Roblox.Users.Api.MultiGetByUserIdRequest Roblox.Users.Api.MultiGetByUsernameRequest Roblox.Users.Api.MultiGetUserByNameResponse Roblox.Users.Api.MultiGetUserResponse Roblox.Users.Api.SearchGetUserResponse Roblox.Users.Api.SetDisplayNameRequest Roblox.Users.Api.UserAgeBracketResponse Roblox.Users.Api.UserCountryCodeResponse Roblox.Users.Api.UserRolesResponse Roblox.Users.Api.UsernameHistoryResponse Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Users.Api.MultiGetUserByNameResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Users.Api.MultiGetUserResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Users.Api.SearchGetUserResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Users.Api.UsernameHistoryResponse] View all endpoints for Users v1