`gather`

Pull everything from several containers into one.

`moveAll` from many sources in one pass, stopping cleanly when the destination fills. The sources actually drawn from come back in `sources` — a source that was already empty is skipped.

In Inventory & stash.

Request

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

Parameters

Name	Type	Required	Description
`srcInvs (src_invs)`	integer[]	yes	Containers to empty.
`dstInv (dst_inv)`	integer	yes	Container to fill.
`premium`	boolean	no	Accepted for backwards compatibility and ignored.

Example request

{ "srcInvs": [10, 11], "dstInv": 4 }

Response

`{ moved, failed, full, dstInv, sources }`.

Field	Type	Meaning
`full`	boolean	True when the destination filled and the sweep stopped early.
`sources`	integer[]	The containers actually drawn from.

Example response

{ "moved": 23, "failed": 0, "full": false, "dstInv": 4, "sources": [10, 11] }

Errors

Code	When
`action_failed`	No character is in the lobby.
`plan_limit`	Not on the free plan.

gather