This page lists all HTTP APIs for working with avatars, such as generating thumbnails, creating outfits, and more. Open Cloud v2 Base URLhttps://apis.roblox.comUserGET/cloud/v2/users/{user_id}:generateThumbnailGenerate User Thumbnail Legacy APIs Legacy APIs with cookie authentication can incorporate breaking changes without notice. We don't recommend them for production applications. Avatars v3 Base URLhttps://avatar.roblox.comPATCH/v3/outfits/{userOutfitId}Updates the contents of an outfit.GET/v3/outfits/{userOutfitId}/detailsGets details about the contents of an outfit.POST/v3/outfits/createCreates a new outfit.ModelsModels Roblox.Api.Avatar.Models.AssetMetaModelV1 Roblox.Api.Avatar.Models.AssetModelV2 Roblox.Api.Avatar.Models.AssetTypeModel Roblox.Api.Avatar.Models.AssetWearModel Roblox.Api.Avatar.Models.BodyColors3Model Roblox.Api.Avatar.Models.OutfitDetailsModelV2 Roblox.Api.Avatar.Models.OutfitModel Roblox.Api.Avatar.Models.OutfitUpdateModelV3 Roblox.Avatarcore.Shared.V3.AssetPosition Roblox.Avatarcore.Shared.V3.AssetRotation Roblox.Avatarcore.Shared.V3.AssetScale Roblox.Platform.Avatar.BodyColorsModelV2 Roblox.Web.Responses.Avatar.ScaleModel View all endpoints for Avatar v3 Avatars v2 Base URLhttps://avatar.roblox.comGET/v2/avatar/avatarReturns details about the authenticated user's avatarGET/v2/avatar/users/{userId}/avatarReturns details about a specified user's avatarGET/v2/avatar/users/{userId}/outfitsGets a list of outfits for the specified user.POST/v2/avatar/set-body-colorsSets the authenticated user's body colorsPOST/v2/avatar/set-wearing-assetsSets the avatar's current assets to the listPOST/v2/outfits/{userOutfitId}/updateUpdates the contents of the outfit.POST/v2/outfits/createCreates a new outfit.PATCH/v2/outfits/{userOutfitId}Updates the contents of an outfit.ModelsModels Roblox.Api.Avatar.Models.AssetMetaModelV1 Roblox.Api.Avatar.Models.AssetModelV2 Roblox.Api.Avatar.Models.AssetTypeModel Roblox.Api.Avatar.Models.AssetWearModel Roblox.Api.Avatar.Models.AvatarApiSuccessResponse Roblox.Api.Avatar.Models.AvatarModelV3 Roblox.Api.Avatar.Models.AvatarPageResponse[Roblox.Api.Avatar.Models.OutfitModel] Roblox.Api.Avatar.Models.BodyColors3Model Roblox.Api.Avatar.Models.BodyColorsModel Roblox.Api.Avatar.Models.EmoteResponseModel Roblox.Api.Avatar.Models.OutfitModel Roblox.Api.Avatar.Models.OutfitUpdateModelV2 Roblox.Api.Avatar.Models.WearRequestModel Roblox.Api.Avatar.Models.WearResponseModel Roblox.Avatarcore.Shared.V3.AssetPosition Roblox.Avatarcore.Shared.V3.AssetRotation Roblox.Avatarcore.Shared.V3.AssetScale Roblox.Platform.Avatar.BodyColorsModelV2 Roblox.Web.Responses.Avatar.ScaleModel Roblox.Web.WebAPI.ApiEmptyResponseModel Avatars v1 Base URLhttps://avatar.roblox.comGET/v1/avatarReturns details about the authenticated user's avatarGET/v1/avatar-rulesReturns the business rules related to avatarsGET/v1/avatar/metadataReturns metadata used by the avatar page of the websiteGET/v1/game-start-infoThe server will call this on game server start to request general information about the universe This is version 1.1, which returns an entry from the UniverseAvatarType enum. During mixed mode this may return unreliable results.GET/v1/outfits/{userOutfitId}/detailsGET/v1/recent-items/{recentItemListType}/listReturns a list of recent items Recent items can be Assets or OutfitsGET/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 wearingGET/v1/users/{userId}/outfitsDeprecated, user v2. Gets a list of outfits for the specified user.POST/v1/avatar/redraw-thumbnailRequests the authenticated user's thumbnail be redrawnPOST/v1/avatar/set-body-colorsSets the authenticated user's body colorsPOST/v1/avatar/set-player-avatar-typeSets the authenticated user's player avatar type (e.g. R6 or R15).POST/v1/avatar/set-scalesSets the authenticated user's scalesPOST/v1/avatar/set-wearing-assetsSets the avatar's current assets to the list - Flagged as obsolete, does not support layered clothing meta paramsPOST/v1/outfits/{userOutfitId}/deleteDeletes the outfitModelsModels 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] Catalog v1 Base URLhttps://catalog.roblox.comGET/v1/asset-to-categoryLists a mapping for assets to category IDs to convert from inventory ID to catalog ID. Creates a mapping to link 'Get More' button in inventory page to the relevant catalog page.GET/v1/asset-to-subcategoryLists a mapping for assets to subcategory IDs to convert from inventory ID to catalog ID. Creates a mapping to link 'Get More' button in inventory page to the relevant catalog page.GET/v1/assets/{assetId}/bundlesLists the bundles a particular asset belongs to. Use the Id of the last bundle in the response to get the next page.GET/v1/bundles/{bundleId}/detailsReturns details about the given bundleId.GET/v1/bundles/{bundleId}/recommendationsGets recommendations for a given bundle, bundleId of 0 returns randomized bundles - Accepts both public and authenticated users.GET/v1/bundles/detailsReturns details about the given bundleIds.GET/v1/categoriesLists Category Names and their Ids.GET/v1/favorites/assets/{assetId}/countGets the favorite count for the given asset Id.GET/v1/favorites/bundles/{bundleId}/countGets the favorite count for the given bundle Id.DELETE/v1/favorites/users/{userId}/assets/{assetId}/favoriteDelete a favorite for an asset by the authenticated user.GET/v1/favorites/users/{userId}/assets/{assetId}/favoriteGets the favorite model for the asset and user.POST/v1/favorites/users/{userId}/assets/{assetId}/favoriteCreate a favorite for an asset by the authenticated user.DELETE/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteDelete favorite for the bundle by the authenticated user.GET/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteGets the favorite model for the bundle and user.POST/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteCreate a favorite for the bundle by the authenticated user.GET/v1/favorites/users/{userId}/favorites/{assetTypeId}/assetsLists the marketplace assets favorited by a given user with the given assetTypeId.GET/v1/favorites/users/{userId}/favorites/{subtypeId}/bundlesLists the bundles favorited by a given user with the given bundle subtypeId.Switched to EAAS style pagination cursors since July 2024.GET/v1/subcategoriesLists Subcategory Names and their Ids.GET/v1/users/{userId}/bundlesLists the bundles owned by a given user.GET/v1/users/{userId}/bundles/{bundleType}POST/v1/catalog/items/detailsReturns list of item details.POST/v1/topic/get-topicsGet topic given TopicRequestModel.ModelsModels Roblox.Catalog.Api.AssetFavoriteModel Roblox.Catalog.Api.BundleCreatorModel Roblox.Catalog.Api.BundleDetailsModel Roblox.Catalog.Api.BundleFavoriteModel Roblox.Catalog.Api.BundleItemDetailModel Roblox.Catalog.Api.BundleProductModel Roblox.Catalog.Api.CatalogSearchDetailedResponseItem Roblox.Catalog.Api.CollectibleItemDetail Roblox.Catalog.Api.FavoriteBundlesResponse Roblox.Catalog.Api.MultigetItemDetailsRequestItem Roblox.Catalog.Api.MultigetItemDetailsRequestModel Roblox.Catalog.Api.OwnedBundleModel Roblox.Catalog.Api.PremiumPricingModel Roblox.Catalog.Api.SaleLocation Roblox.Catalog.Api.Topics.TopicModel Roblox.Catalog.Api.Topics.TopicRequestModel Roblox.Catalog.Api.Topics.TopicResponse Roblox.Marketplacetopicdiscovery.Topicdiscoveryservice.V1Beta1.AvatarItem Roblox.Marketplacetopicdiscovery.Topicdiscoveryservice.V1Beta1.Error Roblox.Paging.ExclusiveStartKeyCursor[System.String] Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int64] Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Catalog.Api.BundleDetailsModel] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Catalog.Api.CatalogSearchDetailedResponseItem] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Catalog.Api.BundleDetailsModel] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Catalog.Api.CatalogSearchDetailedResponseItem] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Catalog.Api.OwnedBundleModel] System.ValueTuple[Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64],Roblox.Paging.ExclusiveStartKeyCursor[System.String]] Metrics v1 Base URLhttps://metrics.roblox.comPOST/v1/bundle-metrics/reportRecords bundle load successes.ModelsModels Roblox.Metrics.Api.RecordBundleLoadRequest Roblox.Metrics.Api.RecordThumbnailLoadRequest Roblox.Metrics.Api.ThumbnailLoadMetadataResponse Roblox.Web.WebAPI.ApiEmptyResponseModel View all endpoints for Metrics v1 Thumbnails v1 Base URLhttps://thumbnails.roblox.comGET/v1/users/avatarGet Avatar Full body shots for the given CSV of userIdsGET/v1/users/avatar-3dGet Avatar 3d object for a userGET/v1/users/avatar-bustGet Avatar Busts for the given CSV of userIdsGET/v1/users/avatar-headshotGet Avatar Headshots for the given CSV of userIdsGET/v1/bundles/thumbnailsGet bundle thumbnails for the given CSV of bundle idsModelsModels Roblox.Thumbnails.Api.Models.UniverseThumbnailsResponse Roblox.Thumbnails.Apis.Models.ThumbnailBatchRequest Roblox.Thumbs.FormatType Roblox.Thumbs.ImageParameters Roblox.Web.Responses.Thumbnails.ThumbnailBatchResponse Roblox.Web.Responses.Thumbnails.ThumbnailResponse Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Thumbnails.Api.Models.UniverseThumbnailsResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Web.Responses.Thumbnails.ThumbnailBatchResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Web.Responses.Thumbnails.ThumbnailResponse] Roblox.Web.WebAPI.Models.ApiErrorModel View all endpoints for Thumbnails v1