ARarcprize
Commands

Execute complex action (requires x,y)

Changed on

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.

post/api/cmd/ACTION6

Request

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).

reasoningunknown

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_PLAYED' | 'NOT_FINISHED' | 'WIN' | 'GAME_OVER' required

Current state of the session:

• NOT_FINISHED - game in progress, not yet WIN or GAME_OVER.
• NOT_PLAYED - no game has been started. • 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.

full_resetboolean

Whether the RESET created a new game rather than resetting the current level.

available_actionsinteger[] required

List of available actions for the current game.

Changes

  • 25b583984ff7Revision changes
    • breaking

      the request property type changed from object to no type

    • warning

      added the new 0.00 enum value to the / response property for the response status

    • warning

      added the new 7.00 enum value to the / response property for the response status

    • warning

      added the new NOT_PLAYED enum value to the response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the NOT_STARTED enum value from the response property for the response status