Schedules

Schedules are themed collections of events for special occasions like festivals. They can have custom themes, backgrounds, and time-based activation.

List schedules

get

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/schedules

Returns all schedules, including their activation periods and themes.

Responses

200

List of schedules

application/json

500

Internal server error

application/json

get

/schedules

HTTPcURLJavaScriptPython

GET /api/schedules HTTP/1.1
Host: events.decentraland.org
Accept: */*

{
  "ok": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Metaverse Music Festival 2024",
      "description": "text",
      "image": "https://example.com",
      "theme": "mvmf_2022",
      "background": [
        "#FF0000",
        "#00FF00"
      ],
      "active": true,
      "active_since": "2026-01-22T00:36:01.456Z",
      "active_until": "2026-01-22T00:36:01.456Z",
      "created_at": "2026-01-22T00:36:01.456Z",
      "updated_at": "2026-01-22T00:36:01.456Z"
    }
  ]
}

Create a schedule

post

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/schedules

Creates a new schedule. Requires authentication and special permissions.

Body

application/json

Schema for creating a new schedule

namestring · max: 50Required

descriptionstring | nullableOptional

imagestring · uri | nullableOptional

themestring · enum | nullableOptionalPossible values:

backgroundstring[]Optional

activebooleanOptionalDefault: true

active_sincestring · date-timeRequired

active_untilstring · date-timeRequired

Responses

200

Schedule created successfully

application/json

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

500

Internal server error

application/json

post

/schedules

HTTPcURLJavaScriptPython

POST /api/schedules HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "name": "text",
  "description": "text",
  "image": "https://example.com",
  "theme": "mvmf_2022",
  "background": [
    "text"
  ],
  "active": true,
  "active_since": "2026-01-22T00:36:01.456Z",
  "active_until": "2026-01-22T00:36:01.456Z"
}

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Metaverse Music Festival 2024",
    "description": "text",
    "image": "https://example.com",
    "theme": "mvmf_2022",
    "background": [
      "#FF0000",
      "#00FF00"
    ],
    "active": true,
    "active_since": "2026-01-22T00:36:01.456Z",
    "active_until": "2026-01-22T00:36:01.456Z",
    "created_at": "2026-01-22T00:36:01.456Z",
    "updated_at": "2026-01-22T00:36:01.456Z"
  }
}

Get schedule by ID

get

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/schedules/{schedule_id}

Retrieves detailed information about a specific schedule.

Path parameters

schedule_idstring · uuidRequired

Schedule UUID

Responses

200

Schedule details

application/json

404

Not found - resource doesn't exist

application/json

500

Internal server error

application/json

get

/schedules/{schedule_id}

HTTPcURLJavaScriptPython

GET /api/schedules/{schedule_id} HTTP/1.1
Host: events.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Metaverse Music Festival 2024",
    "description": "text",
    "image": "https://example.com",
    "theme": "mvmf_2022",
    "background": [
      "#FF0000",
      "#00FF00"
    ],
    "active": true,
    "active_since": "2026-01-22T00:36:01.456Z",
    "active_until": "2026-01-22T00:36:01.456Z",
    "created_at": "2026-01-22T00:36:01.456Z",
    "updated_at": "2026-01-22T00:36:01.456Z"
  }
}

Update a schedule

patch

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/schedules/{schedule_id}

Updates an existing schedule. Requires authentication and special permissions.

Path parameters

schedule_idstring · uuidRequired

Schedule UUID

Body

application/json

Schema for updating a schedule (all fields optional)

namestring · max: 50Optional

descriptionstring | nullableOptional

imagestring · uri | nullableOptional

themestring · enum | nullableOptionalPossible values:

backgroundstring[]Optional

activebooleanOptional

active_sincestring · date-timeOptional

active_untilstring · date-timeOptional

Responses

200

Schedule updated successfully

application/json

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

404

Not found - resource doesn't exist

application/json

500

Internal server error

application/json

patch

/schedules/{schedule_id}

HTTPcURLJavaScriptPython

PATCH /api/schedules/{schedule_id} HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "name": "text",
  "description": "text",
  "image": "https://example.com",
  "theme": "mvmf_2022",
  "background": [
    "text"
  ],
  "active": true,
  "active_since": "2026-01-22T00:36:01.456Z",
  "active_until": "2026-01-22T00:36:01.456Z"
}

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Metaverse Music Festival 2024",
    "description": "text",
    "image": "https://example.com",
    "theme": "mvmf_2022",
    "background": [
      "#FF0000",
      "#00FF00"
    ],
    "active": true,
    "active_since": "2026-01-22T00:36:01.456Z",
    "active_until": "2026-01-22T00:36:01.456Z",
    "created_at": "2026-01-22T00:36:01.456Z",
    "updated_at": "2026-01-22T00:36:01.456Z"
  }
}