`stash`

Read one stash page, with its gold totals and the storage switcher.

Items carry the same full record `inventory` returns. The gold figures are for this page only — `gold` totals across every container.

In Inventory & stash.

Request

POST /api/v1/sessions/{accountKey}/actions/stash

Parameters

Name	Type	Required	Description
`inventoryId (inventory_id)`	integer	no	Which storage; defaults to the main stash. `storages` lists the valid ids.
`premium`	boolean	no	Accepted for backwards compatibility and ignored: every stash page is 12×20.

Example request

{ "inventoryId": 4 }

Response

`{ items, inventoryId, stashGrid, label, totalGold, regularGold, spectralGold, goldContainers, storages }`.

Field	Type	Meaning
`stashGrid`	object	`{cols, rows}` — 12×20 for every stash page.
`totalGold`	integer	Regular plus spectral held on this page.
`goldContainers[]`	object[]	Regular-gold containers only, with the uid and slot a gold transfer needs. The spectral bag is excluded because it has no transfer slot.
`storages`	object[]	The same list `storages` returns, so a switcher needs no second call.

Example response

{
  "items": [
    { "uid": "630211546215118852", "label": "Gold Coin Chest", "shortName": "GoldCoinChest",
      "rarity": "Common", "type": "Utility", "slot": null, "gearScore": 0,
      "count": 1, "maxStack": 1, "stackable": false,
      "contents": 150000, "gold": true, "goldCapacity": 200000,
      "tradable": true, "tradeState": 1, "vendorPrice": null, "vendorMerchant": null,
      "inventoryId": 4, "slotId": 0, "width": 2, "height": 2,
      "iconUrl": "/icons/GoldCoinChest.png", "primary": [], "secondary": [] }
  ],
  "inventoryId": 4,
  "stashGrid": { "cols": 12, "rows": 20 },
  "label": "Stash",
  "totalGold": 153000,
  "regularGold": 150000,
  "spectralGold": 3000,
  "result": 1,
  "goldContainers": [
    { "uid": "630211546215118852", "amount": 150000, "capacity": 200000, "slotId": 0, "name": "GoldCoinChest" }
  ],
  "storages": [
    { "inventoryId": 4, "label": "Stash", "available": true, "expandPrice": 0, "expandable": false, "items": 41 }
  ]
}

Errors

Code	When
`action_failed`	No character is in the lobby, the id is not a storage, or the read timed out.

stash