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.
Game/session identifiers plus the coordinate payload.
Payload for coordinate-based actions (e.g. /api/cmd/ACTION6).
Supplies an (x, y) location on the 64 × 64 game grid along with
the game/session identifiers so the engine can apply the action
to the correct running instance.
Important: Include any cookies (especially AWSALB* cookies) received from previous RESET or ACTION responses to ensure session affinity.
Optional, caller-defined JSON value (≤ 16 KB once serialized) 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.
Snapshot returned after every RESET or ACTION command.
Includes the latest visual frame(s), cumulative progress, the
current game state, and an echo of the triggering action.
One or more consecutive visual frames. Each frame is a 64 × 64
grid of 4-bit colour indices (integers 0-15). Multiple frames
may be returned if the environment advances internally (e.g.,
animations) before settling.
• 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.
Level threshold required to reach the WIN state. Mirrors
the game's configured win condition so agents can adapt
dynamically without hard-coding values.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ARC-AGI-3 Docs","colors":{"primary":"#ff0000"},"logo":{"light":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_light.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=3122221f7af0c3e78e450c122b69592e","dark":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_dark.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=b468accb6e1a9ba07517008ee4720108","href":"https://arcprize.org"},"favicon":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/favicon.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=c3d9d0a706623f6cba41f5bf08c812b6","appearance":{"default":"dark"},"footer":{"socials":{"github":"https://github.com/arcprize/docs","discord":"https://discord.gg/9b77dPAmcA","twitter":"https://twitter.com/arcprize"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"arcprizefoundation","hasAudioNarration":false,"actualSubdomain":"arcprizefoundation","customDomains":["docs.arcprize.org"],"gitSource":{"type":"github","owner":"arcprize","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a8da9cf0d1ad8b280ced3c4","collectionId":"3ba36649-a6aa-47bd-a251-eee251a5ab60","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a8da9cf0d1ad8b280ced3c4"},"feedback":{"edits":true,"thumbs":true,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8da9cf0d1ad8b280ced3c4","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Overview","count":26},{"language":"default","tag":"REST API","count":17},{"language":"default","tag":"Core Concepts","count":15},{"language":"default","tag":"ARC-AGI Toolkit","count":15},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Agents","count":9},{"language":"default","tag":"Games","count":8},{"language":"default","tag":"Commands","count":8},{"language":"default","tag":"Scorecards","count":7},{"language":"default","tag":"Get Started","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/commands/execute-complex-action-requires-xy","slug":"/api-reference/commands/execute-complex-action-requires-xy","pageMetadata":{"title":"Execute complex action (requires x,y)","description":"Issues **ACTION 6**—a two-parameter command that supplies explicit\nX/Y coordinates—to an active game session. Common use-cases\ninclude \"click/tap at (x,y)\", \"place a tile\", or \"shoot a\nprojectile,\" depending on the game's mechanics.\n\nRequired fields \n• `game_id` — the game to act in \n• `guid` — session identifier obtained from RESET \n• `x`,`y` — zero-based grid coordinates (0-63 inclusive)\n\nOn success the server applies the action, advances game logic to\nthe next stable frame, and returns that frame together with the\nupdated score, state, and win condition.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION6","href":"/api-reference/commands/execute-complex-action-requires-xy","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n br: \"br\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Issues \", _jsx(_components.strong, {\n children: \"ACTION 6\"\n }), \"—a two-parameter command that supplies explicit\\nX/Y coordinates—to an active game session. Common use-cases\\ninclude “click/tap at (x,y)”, “place a tile”, or “shoot a\\nprojectile,” depending on the game’s mechanics.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Required fields\", _jsx(_components.br, {}), \"\\n\", \"• \", _jsx(_components.code, {\n children: \"game_id\"\n }), \" — the game to act in\", _jsx(_components.br, {}), \"\\n\", \"• \", _jsx(_components.code, {\n children: \"guid\"\n }), \" — session identifier obtained from RESET\", _jsx(_components.br, {}), \"\\n\", \"• \", _jsx(_components.code, {\n children: \"x\"\n }), \",\", _jsx(_components.code, {\n children: \"y\"\n }), \" — zero-based grid coordinates (0-63 inclusive)\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"On success the server applies the action, advances game logic to\\nthe next stable frame, and returns that frame together with the\\nupdated score, state, and win condition.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Execute complex action (requires x,y)","description":"Issues **ACTION 6**—a two-parameter command that supplies explicit\nX/Y coordinates—to an active game session. Common use-cases\ninclude \"click/tap at (x,y)\", \"place a tile\", or \"shoot a\nprojectile,\" depending on the game's mechanics.\n\nRequired fields \n• `game_id` — the game to act in \n• `guid` — session identifier obtained from RESET \n• `x`,`y` — zero-based grid coordinates (0-63 inclusive)\n\nOn success the server applies the action, advances game logic to\nthe next stable frame, and returns that frame together with the\nupdated score, state, and win condition.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION6","href":"/api-reference/commands/execute-complex-action-requires-xy","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Commands"],"summary":"Execute complex action (requires x,y)","description":"Issues **ACTION 6**—a two-parameter command that supplies explicit\nX/Y coordinates—to an active game session. Common use-cases\ninclude \"click/tap at (x,y)\", \"place a tile\", or \"shoot a\nprojectile,\" depending on the game's mechanics.\n\nRequired fields \n• `game_id` — the game to act in \n• `guid` — session identifier obtained from RESET \n• `x`,`y` — zero-based grid coordinates (0-63 inclusive)\n\nOn success the server applies the action, advances game logic to\nthe next stable frame, and returns that frame together with the\nupdated score, state, and win condition.\n","operationId":"action6","security":["c8a12364-7ef4-4481-bfed-84cd308fbf16"],"requestBody":"cc70f3c0-24a3-4782-813b-b1c5e7ca32b3","responses":{"200":"6803c35a-5c02-4d27-aa0e-dfdd84e75265","400":"146e327c-4fe4-4506-9935-77b28e83f9b0","401":"effdc25a-cb01-4ef6-a068-600657bf8236"},"method":"post","type":"path","servers":["813bc833-cecb-4f1a-8009-fcf36bd1a0a7"],"path":"/api/cmd/ACTION6","baseUrlOptions":["https://three.arcprize.org"],"title":"Execute complex action (requires x,y)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Game/session identifiers plus the coordinate payload.","required":true,"content":{"application/json":{"schema":{"type":"object","description":"Payload for coordinate-based actions (e.g. `/api/cmd/ACTION6`).\nSupplies an `(x, y)` location on the 64 × 64 game grid along with\nthe game/session identifiers so the engine can apply the action\nto the correct running instance.\n\n**Important:** Include any cookies (especially `AWSALB*` cookies) received from previous RESET or ACTION responses to ensure session affinity.\n","properties":{"game_id":{"type":"string","description":"Identifier of the game receiving this action.","isRequired":true,"uniqueKey":"game_id","typeLabel":"string"},"guid":{"type":"string","description":"Server-generated session ID obtained from the RESET call.","isRequired":true,"uniqueKey":"guid","typeLabel":"string"},"x":{"type":"integer","minimum":0,"maximum":63,"description":"Horizontal coordinate on the game grid (0 = left, 63 = right).","isRequired":true,"uniqueKey":"x","typeLabel":"integer"},"y":{"type":"integer","minimum":0,"maximum":63,"description":"Vertical coordinate on the game grid (0 = top, 63 = bottom).","isRequired":true,"uniqueKey":"y","typeLabel":"integer"},"reasoning":{"description":"Optional, caller-defined JSON value (≤ 16 KB once serialized) capturing the\nagent's internal reasoning, model parameters, or any other\nmetadata you'd like to store alongside the action.\n","uniqueKey":"reasoning","typeLabel":"any"}},"required":["game_id","guid","x","y"],"uniqueKey":"","typeLabel":"object"},"examples":{"placeTile":{"title":"placeTile","value":{"game_id":"ls20-016295f7601e","guid":"2fa5332c-2e55-4825-b5c5-df960d504470","x":12,"y":34}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"6803c35a-5c02-4d27-aa0e-dfdd84e75265":{"description":"Frame returned after executing the action.","content":{"application/json":{"schema":{"type":"object","description":"Snapshot returned after every RESET or ACTION command. \nIncludes the latest visual frame(s), cumulative progress, the\ncurrent game state, and an echo of the triggering action.\n","properties":{"game_id":{"type":"string","description":"Game identifier for the running session.","isRequired":true,"uniqueKey":"game_id","typeLabel":"string"},"guid":{"type":"string","description":"Server-generated session ID; use this for all subsequent commands.","isRequired":true,"uniqueKey":"guid","typeLabel":"string"},"frame":{"type":"array","description":"One or more consecutive visual frames. Each frame is a 64 × 64\ngrid of 4-bit colour indices (integers 0-15). Multiple frames\nmay be returned if the environment advances internally (e.g.,\nanimations) before settling.\n","items":{"type":"array","items":{"type":"array","items":{"type":"integer","minimum":0,"maximum":15,"uniqueKey":"frame.items.[INDEX].items.[INDEX].items.[INDEX]","typeLabel":"integer"},"uniqueKey":"frame.items.[INDEX].items.[INDEX]","typeLabel":"integer[]"},"uniqueKey":"frame.items.[INDEX]","typeLabel":"integer[][]"},"isRequired":true,"uniqueKey":"frame","typeLabel":"integer[][][]"},"state":{"type":"string","description":"Current state of the session:\n\n• **NOT_FINISHED** - game in progress, not yet WIN or GAME_OVER. \n• **NOT_PLAYED** - no game has been started.\n• **WIN** - session ended in victory. \n• **GAME_OVER** - session ended in defeat.\n","enum":["NOT_PLAYED","NOT_FINISHED","WIN","GAME_OVER"],"isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"levels_completed":{"type":"integer","description":"Current cumulative number of levels completed for this run.","minimum":0,"maximum":254,"isRequired":true,"uniqueKey":"levels_completed","typeLabel":"integer"},"win_levels":{"type":"integer","description":"Level threshold required to reach the **WIN** state. Mirrors\nthe game's configured win condition so agents can adapt\ndynamically without hard-coding values.\n","minimum":0,"maximum":254,"isRequired":true,"uniqueKey":"win_levels","typeLabel":"integer"},"action_input":{"type":"object","description":"Echo of the command that produced this frame.","properties":{"id":{"type":"integer","minimum":0,"maximum":7,"description":"Numeric `GameAction` ID that produced the frame (`0` is RESET).","uniqueKey":"action_input.id","typeLabel":"integer"},"data":{"type":"object","description":"Additional parameters originally sent with the action.","additionalProperties":true,"uniqueKey":"action_input.data","typeLabel":"object"},"reasoning":{"description":"Optional caller-supplied reasoning value echoed with the action.","uniqueKey":"action_input.reasoning","typeLabel":"any"}},"isRequired":true,"uniqueKey":"action_input","typeLabel":"object"},"available_actions":{"type":"array","description":"List of available actions for the current game.","items":{"type":"integer","enum":[0,1,2,3,4,5,6,7],"uniqueKey":"available_actions.items.[INDEX]","typeLabel":"enum\u003cinteger>"},"isRequired":true,"uniqueKey":"available_actions","typeLabel":"enum\u003cinteger>[]"},"full_reset":{"type":"boolean","description":"Whether the RESET created a new game rather than resetting the current level.","uniqueKey":"full_reset","typeLabel":"boolean"}},"required":["game_id","guid","frame","state","levels_completed","win_levels","action_input","available_actions"],"uniqueKey":"","typeLabel":"object"},"examples":{"frame":{"title":"frame","value":{"game_id":"ls20-016295f7601e","guid":"2fa5332c-2e55-4825-b5c5-df960d504470","frame":[[["…"]]],"state":"NOT_FINISHED","levels_completed":17,"win_levels":254,"action_input":{"id":6,"data":{"x":12,"y":34}},"available_actions":[1,2,3,4]}}},"exampleType":"examples"}},"exampleType":"examples"},"146e327c-4fe4-4506-9935-77b28e83f9b0":{"description":"Bad request - possible causes: \n• Unknown `game_id` \n• `guid` not found or does not belong to the supplied `game_id` \n• `x` or `y` outside the 0-63 range\n","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"effdc25a-cb01-4ef6-a068-600657bf8236":{"description":"Missing or invalid **X-API-Key** header.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"c8a12364-7ef4-4481-bfed-84cd308fbf16":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]}}},"servers":{"813bc833-cecb-4f1a-8009-fcf36bd1a0a7":{"url":"https://three.arcprize.org"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"arc3v1.yaml"},"subdomain":"arcprizefoundation","siteName":"ARC-AGI-3 Docs","title":"Execute complex action (requires x,y) - ARC-AGI-3 Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T14:42:34.886Z","originalFileLocation":"api-reference/commands/execute-complex-action-requires-xy.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Issues ACTION 6—a two-parameter command that supplies explicit X/Y coordinates—to an active game session. Common use-cases include \u0026quot;click/tap at (x,y)\u0026quot;, \u0026quot;place a tile\u0026quot;, or \u0026quot;shoot a projectile,\u0026quot; depending on the game\u0026#x27;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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Execute complex action (requires x,y) - ARC-AGI-3 Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Issues ACTION 6—a two-parameter command that supplies explicit X/Y coordinates—to an active game session. Common use-cases include \u0026quot;click/tap at (x,y)\u0026quot;, \u0026quot;place a tile\u0026quot;, or \u0026quot;shoot a projectile,\u0026quot; depending on the game\u0026#x27;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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://arcprizefoundation.mintlify.app/_mintlify/api/og/v2?division=Commands\u0026amp;title=Execute+complex+action+%28requires+x%2Cy%29\u0026amp;description=Issues+**ACTION+6**%E2%80%94a+two-parameter+command+that+supplies+explicit%0AX%2FY+coordinates%E2%80%94to+an+active+game+session.++Common+use-cases%0Ainclude+%22click%2Ftap+at+%28x%2Cy%29%22%2C+%22p\u0026amp;theme=1de61eb03f71cd07c44a4a8b\u0026amp;signature=453fb378d05bfb548c0c4ffa75796e775720b4f751d4ce97cd0f2b1ffdb628c8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Execute complex action (requires x,y) - ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Issues ACTION 6—a two-parameter command that supplies explicit X/Y coordinates—to an active game session. Common use-cases include \u0026quot;click/tap at (x,y)\u0026quot;, \u0026quot;place a tile\u0026quot;, or \u0026quot;shoot a projectile,\u0026quot; depending on the game\u0026#x27;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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://arcprizefoundation.mintlify.app/_mintlify/api/og/v2?division=Commands\u0026amp;title=Execute+complex+action+%28requires+x%2Cy%29\u0026amp;description=Issues+**ACTION+6**%E2%80%94a+two-parameter+command+that+supplies+explicit%0AX%2FY+coordinates%E2%80%94to+an+active+game+session.++Common+use-cases%0Ainclude+%22click%2Ftap+at+%28x%2Cy%29%22%2C+%22p\u0026amp;theme=1de61eb03f71cd07c44a4a8b\u0026amp;signature=453fb378d05bfb548c0c4ffa75796e775720b4f751d4ce97cd0f2b1ffdb628c8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff0000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/commands/execute-complex-action-requires-xy.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.arcprize.org/#organization\",\"name\":\"ARC-AGI-3 Docs\",\"url\":\"https://docs.arcprize.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_light.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=3122221f7af0c3e78e450c122b69592e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.arcprize.org#website\",\"name\":\"ARC-AGI-3 Docs\",\"url\":\"https://docs.arcprize.org\",\"publisher\":{\"@id\":\"https://docs.arcprize.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy#webpage\",\"url\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy\",\"name\":\"Execute complex action (requires x,y)\",\"description\":\"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.\",\"dateModified\":\"2026-08-25T14:42:34.886Z\",\"isPartOf\":{\"@id\":\"https://docs.arcprize.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Commands\",\"item\":\"https://docs.arcprize.org/api-reference/commands/start-or-reset-game-instance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Execute complex action (requires x,y)\",\"item\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy#apireference\",\"headline\":\"Execute complex action (requires x,y)\",\"name\":\"Execute complex action (requires x,y)\",\"description\":\"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.\",\"url\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy\",\"mainEntityOfPage\":{\"@id\":\"https://docs.arcprize.org/api-reference/commands/execute-complex-action-requires-xy#webpage\"},\"dateModified\":\"2026-08-25T14:42:34.886Z\",\"publisher\":{\"@id\":\"https://docs.arcprize.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.arcprize.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ARC-AGI-3 Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ARC-AGI-3 Docs","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"ARC-AGI Toolkit","pages":[{"title":"ARC-AGI Toolkit","href":"/toolkit/overview"}]},{"tab":"REST API","groups":[{"group":"Using the API","pages":[{"title":"Overview","icon":"file-text","href":"/rest_overview"},{"title":"Rate Limits","icon":"activity","href":"/rate_limits"}]},{"group":"Games","pages":[{"title":"List available games","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/games","href":"/api-reference/games/list-available-games"},{"title":"Retrieve game metadata","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/games/{game_id}","href":"/api-reference/games/retrieve-game-metadata"}]},{"group":"API Reference","pages":[{"title":"Check API health","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/healthcheck","href":"/api-reference/check-api-health"}]},{"group":"Scorecards","pages":[{"title":"Open scorecard","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/scorecard/open","href":"/api-reference/scorecards/open-scorecard"},{"title":"Close scorecard","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/scorecard/close","href":"/api-reference/scorecards/close-scorecard"},{"title":"Retrieve scorecard","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}","href":"/api-reference/scorecards/retrieve-scorecard"},{"title":"Retrieve scorecard (one game)","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}/{game_id}","href":"/api-reference/scorecards/retrieve-scorecard-one-game"}]},{"group":"Commands","pages":[{"title":"Start or reset game instance","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/RESET","href":"/api-reference/commands/start-or-reset-game-instance"},{"title":"Execute simple action 1","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION1","href":"/api-reference/commands/execute-simple-action-1"},{"title":"Execute simple action 2","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION2","href":"/api-reference/commands/execute-simple-action-2"},{"title":"Execute simple action 3","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION3","href":"/api-reference/commands/execute-simple-action-3"},{"title":"Execute simple action 4","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION4","href":"/api-reference/commands/execute-simple-action-4"},{"title":"Execute simple action 5","description":"Issues **ACTION 5** to the specified game session. \nThis is a single-parameter command (no X/Y coordinates): the exact\nin-game effect depends on the title—for example, it might\nrepresent \"jump\", \"rotate\", \"fire\" or \"select option E\".\n\nThe request must include:\n• `game_id` — which game to act on \n• `guid` — the active session identifier returned from RESET \n\nAn optional `reasoning` JSON blob (≤ 16 KB) can be attached for\naudit or research purposes.\n\nA successful call returns the next visual frame(s) and updated\nscore/state.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION5","href":"/api-reference/commands/execute-simple-action-5"},{"title":"Execute complex action (requires x,y)","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION6","href":"/api-reference/commands/execute-complex-action-requires-xy"},{"title":"Execute simple action 7","description":"Issues **ACTION 7** to the specified game session. \nThis is a single-parameter command (no X/Y coordinates): \nACTION7 will always be an undo action for games that support it.\n\nThe request must include:\n• `game_id` — which game to act on \n• `guid` — the active session identifier returned from RESET \n\nAn optional `reasoning` JSON blob (≤ 16 KB) can be attached for\naudit or research purposes.\n\nA successful call returns the next visual frame(s) and updated\nscore/state.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION7","href":"/api-reference/commands/execute-simple-action-7"}]}]}]},"basePath":"","title":"Execute complex action (requires x,y) - ARC-AGI-3 Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}