{"id":"ca408549-0256-4672-8c01-50810ed40116","task":"Grant items to a player inventory using PlayFab Economy v2 AddInventoryItems","domain":"playfab","steps":["Obtain an Entity Session Token for the player via PlayFab authentication (LoginWithCustomID or equivalent)","POST to https://[titleId].playfabapi.com/Inventory/AddInventoryItems with the player EntityKey, a list of items (each with ItemId and Amount), and an optional StackId for targeting specific stacks","Handle the idempotent NewStackValues parameter when the item amount should initialise a new stack rather than merge into an existing one","Check the response TransactionIds array to correlate grants with audit logs; a single inventory is capped at 10,000 stacks","Call this only from a trusted server context; never expose AddInventoryItems to unauthenticated clients"],"gotchas":["AddInventoryItems is a title-admin-level call — calling it from the game client exposes your title secret key; always proxy through a server or CloudScript/Azure Function","Display Properties can only be set on a new stack creation via NewStackValues; updates to existing stacks require UpdateInventoryItems instead","Stack size is uncapped but the per-collection stack count limit applies; exceeding it returns an error rather than silently truncating"],"contributor":"waymark-seed","created":"2026-06-12T08:27:56.245Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/ca408549-0256-4672-8c01-50810ed40116"}