Add File to Asset Candidate

curl --location --request POST 'https://api.lootlocker.com/game/v1/player/assets/candidates/4/file' \ --header 'x-session-token: ' \ --header 'x-session-token;' \ --form 'file=@"/home/b/Downloads/hector-icon.png"' \ --form 'purpose="primary_thumbnail"'

{ "success": true, "asset_candidate": { "id": 1, "player_id": 1, "player_public_uid": "string", "asset_id": 1, "status": "INCOMPLETE", "review_feedback": "string", "data": { "name": "string", "kv_storage": [ { "key": "string", "value": "string" } ], "filters": [ { "key": "string", "value": "string" } ], "data_entities": [ { "name": "string", "data": "string" } ], "context_id": 1 }, "files": [ { "id": 1, "url": "http://example.com", "size": 1, "name": "string", "purpose": "PRIMARY_THUMBNAIL" } ], "primary_thumbnail": "http://example.com", "created_at": "string", "updated_at": "string" } }

Request

Path Params

candidate_id

string

required

The ID of the asset candidate to attach the file to

Example:

Header Params

x-session-token

string

required

Example:

Body Params multipart/form-data

file

required

The file you wish to attach.
Maximum size: 15Mb

Example:

file:///home/b/Downloads/hector-icon.png

purpose

enum<string>

required

Case insensitive purpose

Allowed values:

primary_thumbnailthumbnailfile

Example:

primary_thumbnail

Responses

🟢200Success

application/json

Body

success

boolean

required

asset_candidate

object

required

integer <uint64>

required

>= 1

player_id

integer <uint64>

required

The ID of the player who authered this UGC

>= 1

player_public_uid

string

required

The Public UID of the player who authered this UGC

asset_id

integer <uint64>

required

After promotion this holds a reference to the created Asset

>= 1

status

enum<string>

required

One of 4 statuses: INCOMPLETE, PENDING, APPROVED, DECLINED

Allowed values:

INCOMPLETEPENDINGAPPROVEDDECLINED

review_feedback

string | null

required

Feedback from review to display in game

data

object

required

files

array[object (File) {5}]

required

A list of all files associated with this UGC

primary_thumbnail

string <uri>

required

The URL for the primary thumbnail of the UGC

created_at

string

required

updated_at

string

required