---
title: "Generate bundle creation context which is necessary for the bundle creation process."
method: POST
path: "/v1/bundles/create-context"
tags: ["Assets", "Avatars"]
---

# Generate bundle creation context which is necessary for the bundle creation process.

`POST /v1/bundles/create-context`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/bundles/create-context`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Request body

- RobloxItemConfigurationApiModelsRequestBundleCreateBundleContextRequest: DTO of incoming request from the client to create bundle context which is necessary for bundle creation.
  - `assetQuantities` object: The collection of AssetTypes and their corresponding quantities that are being requested to be uploaded by the client.
  - `bundleDescription` string: Description for the particular bundle that is about to be created.
  - `bundleName` string: Name for the particular bundle that is about to be created.
  - `bundleType` 'Unknown' | 'Body' | 'DynamicHead' | 'Shoes' | 'AvatarAnimations': The bundle type target of the specified action. ['Unknown' = 0, 'Body' = 1, 'DynamicHead' = 2, 'Shoes' = 3, 'AvatarAnimations' = 4]
  - `bodyScale` RobloxItemConfigurationApiModelsBundleBodyScale: The body scale of the bundle.
    - `height` number, double: Determines by what factor the height (top-to-bottom distance) is scaled. Range 0.9-1.05.
    - `width` number, double: Determines by what factor the width (left-to-right distance) is scaled. Range: 0.7-1.0.
    - `head` number, double: Determines by what factor the Head is scaled. Range 0.95-1.0.
    - `bodyType` number, double: Determines by which the shape of a Humanoid rig is interpolated. Range 0.0-1.0.
    - `proportion` number, double: Determines how wide (0) or narrow (1) a Humanoid rig. Range 0.0-1.0.
  - `bodyColorSet` RobloxItemConfigurationApiModelsBundleBodyColorSet: The body color set of the associated Outfit for the body.
    - `headColor3` string: The head color of the avatar.
    - `torsoColor3` string: The torso color of the avatar.
    - `leftArmColor3` string: The left arm color of the avatar.
    - `rightArmColor3` string: The right arm color of the avatar.
    - `leftLegColor3` string: The left leg color of the avatar.
    - `rightLegColor3` string: The right leg color of the avatar.
  - `groupId` integer: The group id that the bundle is meant to belong to.
  - `isEmissive` boolean: Whether the bundle is expected to contain emissive content.

## Response `200`

OK

- RobloxItemConfigurationApiModelsResponseBundleCreateBundleContextResponse: Response DTO for create bundle context endpoint.
  - `operationId` string: ID that was generated for the given bundle create request.

## Other responses

- `400`: 2: Invalid AssetQuantities 3: Invalid Bundle Type 4: Invalid/Null Create Bundle Request 5: Invalid Bundle Description 6: Invalid Bundle Name 7: Inappropriate Bundle Description 8: Inappropriate Bundle Name 12: Invalid Body Scale 13: Invalid Body Color Set 14: Group creator not supported. 15: Request is missing required asset. 16: Asset counts must have non-zero, positive counts. 17: Too many asset types provided. 18: Creation fee is invalid. 19: Invalid Token ID. 20: Invalid Group ID.
- `401`: 0: Authorization has been denied for this request. 10: User not found
- `403`: 0: Token Validation Failed 9: User does not have bundle creation permission 106: Missing ID verification. 107: User's creation access is blocked. 110: Missing CatalogItemCreator role. 111: Missing Group Permission 112: Item type is not allowed.
- `412`: 11: Daily bundle creation limit reached 21: Bundle upload quota exceeded for this bundle type.
- `500`: 103: Publishing gateway returns denied without any reason 104: Publishing gateway returns unexpected reason 105: Publishing gateway returns unexpected access status
- `503`: 1: Service Unavailable

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/bundles/create-context/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/c2ba38e6ba62?raw)