Upload File for Player (with optional key for upsert)

POST

https://api.lootlocker.io/server/players/{player_id}/files

Upload a file for the player. If a key is provided and a file with that key already exists for this player, the file will be updated (appending a new revision). If no file with that key exists, a new file will be created. If no key is provided, a new file is always created (backward compatible).

Request

Authorization

Path Params

Header Params

Body Params multipart/form-data

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.lootlocker.io/server/players/12345/files' \
--header 'x-auth-token: {{server_api_key}}' \
--form 'file=@""' \
--form 'purpose="save_game"' \
--form 'public="true"' \
--form 'key="my_save_slot_1"'

Response Example

{
    "id": 0,
    "revision_id": "string",
    "name": "string",
    "key": "string",
    "size": 0,
    "purpose": "string",
    "url": "string",
    "url_expires_at": "2019-08-24T14:15:22.123Z",
    "created_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-09-29 11:05:08

Get File By Key for Player

Delete File By Key for Player