Profile Settings

User profile settings including email preferences, notification settings, and administrative permissions.

List profile settings

get

/profiles/settings

Returns profile settings for all users (admin only endpoint). Requires authentication and edit_any_profile permission.

Responses

200

List of profile settings

application/json

okbooleanOptionalExample: true

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

500

Internal server error

application/json

get/profiles/settings

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

{
  "ok": true,
  "data": [
    {
      "user": "text",
      "email": "[email protected]",
      "email_verified": true,
      "email_verified_at": "2026-01-01T00:00:00.000Z",
      "email_updated_at": "2026-01-01T00:00:00.000Z",
      "use_local_time": true,
      "notify_by_email": false,
      "notify_by_browser": false,
      "permissions": [
        "approve_own_event"
      ],
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Get my profile settings

get

/profiles/me/settings

Returns the profile settings for the authenticated user.

Responses

200

Profile settings

application/json

okbooleanOptionalExample: true

401

Unauthorized - authentication required

application/json

500

Internal server error

application/json

get/profiles/me/settings

GET /api/profiles/me/settings HTTP/1.1
Host: events.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "user": "text",
    "email": "[email protected]",
    "email_verified": true,
    "email_verified_at": "2026-01-01T00:00:00.000Z",
    "email_updated_at": "2026-01-01T00:00:00.000Z",
    "use_local_time": true,
    "notify_by_email": false,
    "notify_by_browser": false,
    "permissions": [
      "approve_own_event"
    ],
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}

Update my profile settings

patch

/profiles/me/settings

Updates the authenticated user's profile settings (email, notifications, etc.).

Body

Schema for updating own profile settings

emailstring · emailOptional

Update email address

email_verifiedbooleanOptional

Mark email as verified (admin only)

use_local_timebooleanOptional

notify_by_emailbooleanOptional

notify_by_browserbooleanOptional

Responses

200

Settings updated successfully

application/json

okbooleanOptionalExample: true

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

500

Internal server error

application/json

patch/profiles/me/settings

PATCH /api/profiles/me/settings HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "email": "[email protected]",
  "email_verified": true,
  "use_local_time": true,
  "notify_by_email": true,
  "notify_by_browser": true
}

{
  "ok": true,
  "data": {
    "user": "text",
    "email": "[email protected]",
    "email_verified": true,
    "email_verified_at": "2026-01-01T00:00:00.000Z",
    "email_updated_at": "2026-01-01T00:00:00.000Z",
    "use_local_time": true,
    "notify_by_email": false,
    "notify_by_browser": false,
    "permissions": [
      "approve_own_event"
    ],
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}

Get profile settings by address

get

/profiles/{profile_id}/settings

Returns profile settings for a specific user (admin only). Requires authentication and edit_any_profile permission.

Path parameters

profile_idstringRequired

Ethereum address of the user

Example: 0x1234567890123456789012345678901234567890Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

Profile settings

application/json

okbooleanOptionalExample: true

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

get/profiles/{profile_id}/settings

GET /api/profiles/{profile_id}/settings HTTP/1.1
Host: events.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "user": "text",
    "email": "[email protected]",
    "email_verified": true,
    "email_verified_at": "2026-01-01T00:00:00.000Z",
    "email_updated_at": "2026-01-01T00:00:00.000Z",
    "use_local_time": true,
    "notify_by_email": false,
    "notify_by_browser": false,
    "permissions": [
      "approve_own_event"
    ],
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}

Update profile settings

patch

/profiles/{profile_id}/settings

Updates permissions for a specific user (admin only). Requires authentication and edit_any_profile permission.

Path parameters

profile_idstringRequired

Ethereum address of the user

Pattern: ^0x[a-fA-F0-9]{40}$

Body

Schema for updating another user's profile settings (admin only)

Responses

200

Settings updated successfully

application/json

okbooleanOptionalExample: true

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/profiles/{profile_id}/settings

PATCH /api/profiles/{profile_id}/settings HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "permissions": [
    "approve_own_event"
  ]
}

{
  "ok": true,
  "data": {
    "user": "text",
    "email": "[email protected]",
    "email_verified": true,
    "email_verified_at": "2026-01-01T00:00:00.000Z",
    "email_updated_at": "2026-01-01T00:00:00.000Z",
    "use_local_time": true,
    "notify_by_email": false,
    "notify_by_browser": false,
    "permissions": [
      "approve_own_event"
    ],
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}