Execute complex action (requires x,y)

Issues ACTION 6—a two-parameter command that supplies explicit X/Y coordinates—to an active game session. Common use-cases include “click/tap at (x,y)”, “place a tile”, or “shoot a projectile,” depending on the game's mechanics.

Required fields
• game_id — the game to act in
• guid — session identifier obtained from RESET
• x,y — zero-based grid coordinates (0-63 inclusive)

On success the server applies the action, advances game logic to the next stable frame, and returns that frame together with the updated score, state, and win condition.

Request body

game_idstring required

Identifier of the game receiving this action.

guidstring required

Server-generated session ID obtained from the RESET call.

xinteger required

Horizontal coordinate on the game grid (0 = left, 63 = right).

yinteger required

Vertical coordinate on the game grid (0 = top, 63 = bottom).

reasoningobject

Optional, caller-defined JSON blob (≤ 16 KB) capturing the agent's internal reasoning, model parameters, or any other metadata you'd like to store alongside the action.

Response

Frame returned after executing the action.

game_idstring required

Game identifier for the running session.

guidstring required

Server-generated session ID; use this for all subsequent commands.

state'NOT_FINISHED' | 'NOT_STARTED' | 'WIN' | 'GAME_OVER' required

Current state of the session:

• NOT_FINISHED - game in progress, not yet WIN or GAME_OVER.
• NOT_STARTED - session has ended (WIN or GAME_OVER) and requires RESET.
• WIN - session ended in victory.
• GAME_OVER - session ended in defeat.

levels_completedinteger required

Current cumulative number of levels completed for this run.

win_levelsinteger required

Level threshold required to reach the WIN state. Mirrors the game's configured win condition so agents can adapt dynamically without hard-coding values.

available_actionsinteger[] required

List of available actions for the current game.

v1

Execute complex action (requires x,y)

Request body

Response