`enter`

Enter the lobby as a character. Most other actions need this first.

Called while already on another character it switches: the lobby is left, the roster re-read and the new character entered — which is what the game's own client does. Anything cached against the old character (an open marketplace, a trade channel) does not survive the switch.

In Session & character.

Request

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

Parameters

Name	Type	Required	Description
`characterId (character_id)`	string	yes	From `chars`.

Example request

{ "characterId": "630211546215118851" }

Response

`{ ok: true, characterId, switched }`.

Field	Type	Meaning
`switched`	boolean	True when this replaced a character that was already in the lobby.

Example response

{ "ok": true, "result": 1, "characterId": "630211546215118851", "switched": false }

Errors

Code	When
`action_failed`	The id is not on this account, or the lobby refused the entry.

enter