Skip to main content

XblTitleStorageUploadBlobAsync

Uploads blob data to title storage.

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
An xbox live context handle created with XblContextCreateHandle. blobMetadata   _In_
Type: XblTitleStorageBlobMetadata
Contains properties required to upload the buffer to title storage. Uploads require a service configuration Id, blob path, blob type and storage type at a minimum. blobBuffer   _In_
Type: uint8_t*
The buffer containing the blob data to upload. This buffer must be available for the duration of the async operation. Clients should not modify the buffer while an upload is in progress. blobBufferCount   _In_
Type: size_t
The length of blobBuffer. etagMatchCondition   _In_
Type: XblTitleStorageETagMatchCondition
The ETag match condition used to determine if the blob data should be uploaded. preferredUploadBlockSize   _In_
Type: size_t
The preferred upload block size in bytes for binary blobs. Binary blobs will be uploaded in multiple chunks of this size if they exceed it. Larger sizes are preferred by the service. If timeouts occur, the app should retry with a smaller size. Block size must be within the 1K to 4MB range. This method will use a default size if this parameter is not within the acceptable range. The current minimum size is 1024 bytes, maximum size is 4194304 bytes and the default size is 262144 bytes. (Optional) async   _In_
Type: XAsyncBlock*
Caller allocated AsyncBlock.

Return value

Type: HRESULT HRESULT return code for this API operation.

REST Call

V1 PUT json/users/xuid()/scids//data/,
V1 PUT global/scids//data/,
V1 PUT sessions//scids//data/,

Requirements

Header: title_storage_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

title_storage_c
Last modified on August 4, 2026