Games

Game management and retrieval operations

Get games

get

https://exploration-games.decentraland.orghttps://exploration-games.decentraland.zone

/api/games

Retrieve all active games or all games (including inactive) with the 'all' query parameter

Query parameters

allbooleanOptional

Include inactive games

Responses

200

List of games

application/json

get

/api/games

HTTPcURLJavaScriptPython

GET /api/games HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*

200

List of games

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Puzzle Master",
      "parcel": "10,20",
      "active": true
    }
  ]
}

Create a new game

post

https://exploration-games.decentraland.orghttps://exploration-games.decentraland.zone

/api/games

Create a new game at a specific parcel location (Admin only)

Body

application/json

namestringRequired

Game name

Example: Puzzle Master

xinteger · min: -150 · max: 150Required

X coordinate of the parcel

Example: 10

yinteger · min: -150 · max: 150Required

Y coordinate of the parcel

Example: 20

Responses

201

Game created successfully

application/json

400

Invalid request payload

application/json

post

/api/games

HTTPcURLJavaScriptPython

POST /api/games HTTP/1.1
Host: exploration-games.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "name": "Puzzle Master",
  "x": 10,
  "y": 20
}

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Puzzle Master",
    "parcel": "10,20",
    "active": true
  }
}

Update a game

patch

https://exploration-games.decentraland.orghttps://exploration-games.decentraland.zone

/api/games/{id}

Update game name and parcel location (Admin only)

Path parameters

idstring · uuidRequired

Game ID (UUID)

Body

application/json

namestringRequired

Game name

Example: Puzzle Master

xinteger · min: -150 · max: 150Required

X coordinate of the parcel

Example: 10

yinteger · min: -150 · max: 150Required

Y coordinate of the parcel

Example: 20

Responses

204

Game updated successfully

400

Invalid request or game not found

application/json

patch

/api/games/{id}

HTTPcURLJavaScriptPython

PATCH /api/games/{id} HTTP/1.1
Host: exploration-games.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "name": "Puzzle Master",
  "x": 10,
  "y": 20
}

No content

Deactivate a game

patch

https://exploration-games.decentraland.orghttps://exploration-games.decentraland.zone

/api/games/{id}/deactivate

Deactivate a game by ID (Admin only)

Path parameters

idstring · uuidRequired

Game ID (UUID)

Responses

204

Game deactivated successfully

400

Invalid UUID

application/json

patch

/api/games/{id}/deactivate

HTTPcURLJavaScriptPython

PATCH /api/games/{id}/deactivate HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*

No content