Bulk upsert metadata

POST

https://api.lootlocker.io/admin/game/{game_id}/metadata/bulk

Upsert up to 500 metadata entries across multiple sources in a single
request. Each entry is independently created or updated (insert on first
write, update on conflict). Failures on individual entries do not abort
the batch — the response reports per-entry results.

Request

Authorization

API Key

Add parameter in header

x-auth-token

Example:

x-auth-token: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Batch completed. Inspect successful / failed counts and the errors array for per-entry details.

Body

🟠400

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.lootlocker.io/admin/game//metadata/bulk' \
--header 'x-auth-token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sources": [
        {
            "source": "player",
            "source_id": "01HX3QJBR4E8YZ0KFGN5MP6T2W",
            "entries": [
                {
                    "key": "player_level",
                    "type": "string",
                    "value": 42,
                    "tags": [
                        "combat",
                        "stats"
                    ],
                    "access": [
                        "game_api.read"
                    ]
                }
            ]
        }
    ]
}'

Response Example

200 - Example 1

{
    "successful": 8,
    "failed": 2,
    "errors": [
        {
            "source_id": "string",
            "key": "string",
            "error": "string"
        }
    ]
}

Modified at 2026-02-25 23:58:05

List Multisource Metadata

List