3 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

Roblox.Thumbnails.Apis.Models.ThumbnailBatchRequest — openapi

Properties

NameTypeRequiredDescription
requestIdstringfalseThe request id. (Generated client side, used to represent the items in the request)
targetIdintegerfalseThe thumbnail target id
tokenstringfalseAlternative ase token used to identify a thumbnail
aliasstringfalseAlternative string used to identify a thumbnail instead of targetId
typestringfalseThe type of the thumbnails ['Avatar' = 1, 'AvatarHeadShot' = 2, 'GameIcon' = 3, 'BadgeIcon' = 4, 'GameThumbnail' = 5, 'GamePass' = 6, 'Asset' = 7, 'BundleThumbnail' = 8, 'Outfit' = 9, 'GroupIcon' = 10, 'DeveloperProduct' = 11, 'AvatarBust' = 12, 'AutoGeneratedAsset' = 13, 'PlaceIcon' = 14, 'AutoGeneratedGameIcon' = 15, 'ForceAutoGeneratedGameIcon' = 16, 'Look' = 17, 'CreatorContextAsset' = 18, 'Screenshot' = 19]
sizestringfalseThe thumbnail size
formatstringfalseThe thumbnail format
isCircularbooleanfalseIs the thumbnail circular shape
accessContextstringfalseAccess context for asset permission checks (only relevant for Asset thumbnail types)
headShapestringfalseHead shape for dynamic head thumbnails (only relevant for Asset thumbnail types with dynamic head)
includeBackgroundbooleanfalseWhether to include a background in avatar thumbnails (defaults to false)
includeProfileFramebooleanfalseWhether to composite the user's equipped profile frame into the thumbnail (defaults to false). When true the returned image has the frame baked in server-side.

Complete Schema

{
  "type": "object",
  "properties": {
    "requestId": {
      "description": "The request id. (Generated client side, used to represent the items in the request)",
      "type": "string"
    },
    "targetId": {
      "format": "int64",
      "description": "The thumbnail target id",
      "type": "integer"
    },
    "token": {
      "description": "Alternative ase token used to identify a thumbnail",
      "type": "string"
    },
    "alias": {
      "description": "Alternative string used to identify a thumbnail\ninstead of targetId",
      "type": "string"
    },
    "type": {
      "description": "The type of the thumbnails ['Avatar' = 1, 'AvatarHeadShot' = 2, 'GameIcon' = 3, 'BadgeIcon' = 4, 'GameThumbnail' = 5, 'GamePass' = 6, 'Asset' = 7, 'BundleThumbnail' = 8, 'Outfit' = 9, 'GroupIcon' = 10, 'DeveloperProduct' = 11, 'AvatarBust' = 12, 'AutoGeneratedAsset' = 13, 'PlaceIcon' = 14, 'AutoGeneratedGameIcon' = 15, 'ForceAutoGeneratedGameIcon' = 16, 'Look' = 17, 'CreatorContextAsset' = 18, 'Screenshot' = 19]",
      "enum": [
        "Avatar",
        "AvatarHeadShot",
        "GameIcon",
        "BadgeIcon",
        "GameThumbnail",
        "GamePass",
        "Asset",
        "BundleThumbnail",
        "Outfit",
        "GroupIcon",
        "DeveloperProduct",
        "AvatarBust",
        "AutoGeneratedAsset",
        "PlaceIcon",
        "AutoGeneratedGameIcon",
        "ForceAutoGeneratedGameIcon",
        "Look",
        "CreatorContextAsset",
        "Screenshot"
      ],
      "type": "string"
    },
    "size": {
      "description": "The thumbnail size",
      "type": "string"
    },
    "format": {
      "description": "The thumbnail format",
      "type": "string"
    },
    "isCircular": {
      "description": "Is the thumbnail circular shape",
      "type": "boolean"
    },
    "accessContext": {
      "description": "Access context for asset permission checks (only relevant for Asset thumbnail types)",
      "type": "string"
    },
    "headShape": {
      "description": "Head shape for dynamic head thumbnails (only relevant for Asset thumbnail types with dynamic head)",
      "type": "string"
    },
    "includeBackground": {
      "description": "Whether to include a background in avatar thumbnails (defaults to false)",
      "type": "boolean"
    },
    "includeProfileFrame": {
      "description": "Whether to composite the user's equipped profile frame into the thumbnail (defaults to false).\nWhen true the returned image has the frame baked in server-side.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}