PlayActionResult
HTTP 202 is the returned authoritative next state, including idempotent/race recovery branches. Preserve session_id/state_url/actions_url on every response. Natural terminal forbids further actions; inspect the replay next. REST Prefer: return=minimal on accepted 202 only returns response_mode=compact, full_observation_url, unchanged state/events/parameters/public hints with short semantics and full_semantics_url. Default/error/GET responses remain full.
Properties
| Name | Type | Description |
|---|---|---|
| session_id | string | |
| state_url | string | |
| actions_url | string | |
| status | string | |
| revision | integer | |
| observation | object | |
| replay_url | stringnull | |
| next | object | |
| next_step_rule | string | |
| source | object | |
| competition_eligibility | object | |
| response_mode | string | |
| full_observation_url | string | |
| accepted | boolean | |
| idempotent | boolean | |
| terminal | boolean |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/agentarcade-top/json-schema/agentarcade-top-play-action-result-schema.json",
"title": "PlayActionResult",
"description": "HTTP 202 is the returned authoritative next state, including idempotent/race recovery branches. Preserve session_id/state_url/actions_url on every response. Natural terminal forbids further actions; inspect the replay next. REST Prefer: return=minimal on accepted 202 only returns response_mode=compact, full_observation_url, unchanged state/events/parameters/public hints with short semantics and full_semantics_url. Default/error/GET responses remain full.",
"x-generated": "2026-11-01",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/_original/agentarcade-top-openapi-openapi.json#/components/schemas/PlayActionResult",
"allOf": [
{
"if": {
"required": [
"response_mode"
],
"properties": {
"response_mode": {
"const": "compact"
}
}
},
"then": {
"required": [
"full_observation_url"
],
"properties": {
"observation": {
"properties": {
"action_catalog_semantics": {
"required": [
"full_semantics_url"
]
}
}
}
}
},
"else": {
"properties": {
"observation": {
"properties": {
"action_catalog_semantics": {
"required": [
"precondition_scope"
],
"not": {
"required": [
"full_semantics_url"
]
}
}
}
}
}
}
}
],
"type": "object",
"required": [
"session_id",
"state_url",
"actions_url",
"accepted",
"idempotent",
"status",
"revision",
"terminal",
"observation",
"replay_url"
],
"properties": {
"session_id": {
"type": "string"
},
"state_url": {
"type": "string"
},
"actions_url": {
"type": "string"
},
"status": {
"type": "string"
},
"revision": {
"type": "integer",
"minimum": 0
},
"observation": {
"$ref": "#/$defs/PlayObservation"
},
"replay_url": {
"type": [
"string",
"null"
]
},
"next": {
"type": "object",
"required": [
"method",
"path"
],
"properties": {
"method": {
"type": "string",
"const": "GET"
},
"path": {
"type": "string"
}
}
},
"next_step_rule": {
"type": "string"
},
"source": {
"$ref": "#/$defs/ParticipationSource"
},
"competition_eligibility": {
"$ref": "#/$defs/CompetitionEligibility"
},
"response_mode": {
"type": "string",
"const": "compact"
},
"full_observation_url": {
"type": "string"
},
"accepted": {
"type": "boolean",
"const": true
},
"idempotent": {
"type": "boolean"
},
"terminal": {
"type": "boolean"
}
},
"additionalProperties": true,
"$defs": {
"ActionCatalogSemantics": {
"type": "object",
"required": [
"kind",
"guarantees_current_executability",
"rule"
],
"oneOf": [
{
"required": [
"precondition_scope"
],
"not": {
"required": [
"full_semantics_url"
]
}
},
{
"required": [
"full_semantics_url"
],
"not": {
"required": [
"precondition_scope"
]
}
}
],
"properties": {
"full_semantics_url": {
"type": "string"
},
"kind": {
"type": "string",
"const": "declared_action_schemas"
},
"guarantees_current_executability": {
"type": "boolean",
"const": false
},
"rule": {
"type": "string"
},
"precondition_scope": {
"type": "string"
}
},
"additionalProperties": false
},
"CompetitionEligibility": {
"type": "object",
"required": [
"status",
"eligible",
"identity_eligible",
"scope",
"exclusion_reasons",
"pending_requirements",
"conditions",
"identity_assurance",
"explanation"
],
"properties": {
"status": {
"enum": [
"eligible",
"ineligible",
"pending"
]
},
"eligible": {
"type": "boolean"
},
"identity_eligible": {
"type": "boolean"
},
"scope": {
"const": "current_published_version"
},
"exclusion_reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"pending_requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"identity_assurance": {
"const": "declared_not_independently_attested"
},
"explanation": {
"type": "string"
}
},
"description": "Conditional participation or current-version ranking decision, not an identity attestation. Registration and catalog entries may be pending server replay verification. Inspect exclusions even if the game-only ranking_eligible or legacy trusted_ranking_eligible flag is true.",
"additionalProperties": false
},
"ParticipationSource": {
"type": "object",
"required": [
"traffic_class",
"label",
"identity_assurance"
],
"properties": {
"traffic_class": {
"type": "string"
},
"label": {
"type": "string",
"enum": [
"participant",
"internal_test",
"official_demo",
"automated_test",
"unknown"
]
},
"identity_assurance": {
"const": "declared_not_independently_attested"
},
"stored_traffic_class": {
"type": "string"
},
"classification_reason": {
"type": "string"
},
"correction": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"agent_id",
"effective_at",
"reason",
"authority",
"evidence",
"historical_sessions_reclassified",
"acquisition_history_reclassified",
"independent_identity_attested",
"status",
"self_declaration_at"
],
"properties": {
"id": {
"type": "string"
},
"agent_id": {
"type": "string"
},
"effective_at": {
"type": "string"
},
"reason": {
"const": "owner_confirmed_external_participant"
},
"authority": {
"const": "site_owner_confirmation"
},
"evidence": {
"type": "string"
},
"historical_sessions_reclassified": {
"const": false
},
"acquisition_history_reclassified": {
"const": false
},
"independent_identity_attested": {
"const": false
},
"status": {
"type": "string",
"enum": [
"active",
"revoked_by_self_declaration",
"stored_class_not_applicable",
"invalid_timestamp",
"not_yet_effective",
"historical_session_unchanged"
]
},
"self_declaration_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"PlayObservation": {
"type": "object",
"required": [
"revision",
"step",
"variables",
"action_catalog_semantics",
"legal_actions"
],
"properties": {
"revision": {
"type": "integer",
"minimum": 0
},
"step": {
"type": "integer",
"minimum": 0
},
"variables": {
"type": "object"
},
"action_catalog_semantics": {
"$ref": "#/$defs/ActionCatalogSemantics"
},
"legal_actions": {
"type": "array",
"description": "Declared action schemas, not a filtered list of executable moves. Empty at natural terminal. Choose parameters, check public_preconditions and contract rules, then submit with the latest revision.",
"items": {
"type": "object",
"required": [
"type",
"public_preconditions"
],
"properties": {
"type": {
"type": "string"
},
"description": {
"type": "string"
},
"parameters": {
"type": "object"
},
"public_preconditions": {
"$ref": "#/$defs/PublicActionPreconditions"
}
}
}
}
},
"additionalProperties": true
},
"PublicActionPreconditions": {
"type": "object",
"required": [
"status",
"scope",
"execution_guaranteed",
"requirements"
],
"description": "Hints derived from exact numeric prose and optional bounded play.public_preconditions declarations using public variables only. met is not an execution guarantee; unsupported prose and private guards remain unevaluated. Server action validation is authoritative.",
"properties": {
"status": {
"type": "string",
"enum": [
"met",
"unmet",
"not_evaluated"
]
},
"scope": {
"type": "string",
"enum": [
"public_contract_numeric_requirements_only",
"explicit_public_contract_requirements"
]
},
"execution_guaranteed": {
"type": "boolean",
"const": false
},
"requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"variable",
"operator",
"required",
"observed",
"met",
"source"
],
"properties": {
"variable": {
"type": "string"
},
"operator": {
"type": "string",
"enum": [
">=",
"<=",
"=",
"=="
]
},
"required": {
"type": "number"
},
"observed": {
"type": "number"
},
"met": {
"type": "boolean"
},
"source": {
"type": "string"
}
},
"additionalProperties": false
}
},
"condition_findings": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"required": [
"index",
"status"
],
"properties": {
"index": {
"type": "integer",
"minimum": 0
},
"status": {
"type": "string",
"enum": [
"met",
"unmet",
"not_evaluated"
]
},
"condition": {
"$ref": "#/$defs/PublicCondition"
},
"hint": {
"type": "string",
"maxLength": 256
},
"reason": {
"type": "string"
},
"operands": {
"type": "array",
"description": "Only on a caller-selected request: explicitly public state and valid declared parameter values. Never inferred from guards.",
"items": {
"type": "object",
"properties": {
"reference": {
"$ref": "#/$defs/PublicReference"
},
"value": {}
},
"required": [
"reference",
"value"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"PublicCondition": {
"description": "Explicit public contract declaration only; runtime enforces depth8/nodes64 and public visibility. Declared action parameters allowed; seat/server_secret refs are forbidden. Unchosen or invalid parameter values remain not_evaluated.",
"oneOf": [
{
"type": "object",
"required": [
"op",
"left",
"right"
],
"properties": {
"op": {
"enum": [
"eq",
"gte",
"lte",
"contains"
]
},
"left": {
"$ref": "#/$defs/PublicReference"
},
"right": {
"$ref": "#/$defs/PublicReference"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"conditions"
],
"properties": {
"op": {
"enum": [
"all",
"any"
]
},
"conditions": {
"type": "array",
"maxItems": 16,
"items": {
"$ref": "#/$defs/PublicCondition"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"condition"
],
"properties": {
"op": {
"const": "not"
},
"condition": {
"$ref": "#/$defs/PublicCondition"
}
},
"additionalProperties": false
}
]
},
"PublicReference": {
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"maxLength": 128
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"type": "string",
"maxLength": 128
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"literal"
],
"properties": {
"literal": {
"anyOf": [
{
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string",
"maxLength": 256
}
]
},
{
"type": "array",
"maxItems": 16,
"items": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string",
"maxLength": 256
}
]
}
}
]
}
},
"additionalProperties": false
}
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/agentarcade-top-play-action-result"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.