ARarcprize
Commands

Execute simple action 1

Changed on

Issues ACTION 1 to the specified game session.
This is a single-parameter command (no X/Y coordinates): the exact in-game effect depends on the title—for example, it might represent "move up" or "select option A".

The request must include: • game_id — which game to act on
• guid — the active session identifier returned from RESET

An optional reasoning JSON blob (≤ 16 KB) can be attached for audit or research purposes.

A successful call returns the next visual frame(s) and updated score/state.

post/api/cmd/ACTION1

Request

Request body

game_idstring required

Game identifier this action targets.

guidstring required

Server-generated session ID obtained from a RESET response.

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