> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/apis/apis/events/profile-settings.md).
# Profile Settings
User profile settings including email preferences, notification settings, and administrative permissions.
## List profile settings
> Returns profile settings for all users (admin only endpoint).\
> Requires authentication and edit\_any\_profile permission.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Events API","version":"1.0.0"},"tags":[{"name":"Profile Settings","description":"User profile settings including email preferences, notification settings,\nand administrative permissions.\n"}],"servers":[{"url":"https://events.decentraland.org/api","description":"Production server"},{"url":"https://events.decentraland.zone/api","description":"Development server"},{"url":"http://localhost:4000/api","description":"Local development server"}],"security":[],"paths":{"/profiles/settings":{"get":{"tags":["Profile Settings"],"summary":"List profile settings","description":"Returns profile settings for all users (admin only endpoint).\nRequires authentication and edit_any_profile permission.\n","operationId":"listProfileSettings","responses":{"200":{"description":"List of profile settings","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","description":"User profile settings and preferences","properties":{"user":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User's Ethereum address"},"email":{"type":"string","format":"email","nullable":true,"description":"User's email address"},"email_verified":{"type":"boolean","description":"Whether the email has been verified"},"email_verified_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was verified"},"email_updated_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was last updated"},"use_local_time":{"type":"boolean","description":"Whether to display times in local timezone","default":true},"notify_by_email":{"type":"boolean","description":"Whether to send email notifications","default":false},"notify_by_browser":{"type":"boolean","description":"Whether to send browser push notifications (deprecated)","default":false},"permissions":{"type":"array","description":"User's special permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile","test_any_notification"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["user"]}}}}}}},"401":{"description":"Unauthorized - authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"403":{"description":"Forbidden - insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}}}}}}}
```
## Get my profile settings
> Returns the profile settings for the authenticated user.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Events API","version":"1.0.0"},"tags":[{"name":"Profile Settings","description":"User profile settings including email preferences, notification settings,\nand administrative permissions.\n"}],"servers":[{"url":"https://events.decentraland.org/api","description":"Production server"},{"url":"https://events.decentraland.zone/api","description":"Development server"},{"url":"http://localhost:4000/api","description":"Local development server"}],"security":[],"paths":{"/profiles/me/settings":{"get":{"tags":["Profile Settings"],"summary":"Get my profile settings","description":"Returns the profile settings for the authenticated user.\n","operationId":"getMyProfileSettings","responses":{"200":{"description":"Profile settings","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","description":"User profile settings and preferences","properties":{"user":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User's Ethereum address"},"email":{"type":"string","format":"email","nullable":true,"description":"User's email address"},"email_verified":{"type":"boolean","description":"Whether the email has been verified"},"email_verified_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was verified"},"email_updated_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was last updated"},"use_local_time":{"type":"boolean","description":"Whether to display times in local timezone","default":true},"notify_by_email":{"type":"boolean","description":"Whether to send email notifications","default":false},"notify_by_browser":{"type":"boolean","description":"Whether to send browser push notifications (deprecated)","default":false},"permissions":{"type":"array","description":"User's special permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile","test_any_notification"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["user"]}}}}}},"401":{"description":"Unauthorized - authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}}}}}}}
```
## Update my profile settings
> Updates the authenticated user's profile settings (email, notifications, etc.).
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Events API","version":"1.0.0"},"tags":[{"name":"Profile Settings","description":"User profile settings including email preferences, notification settings,\nand administrative permissions.\n"}],"servers":[{"url":"https://events.decentraland.org/api","description":"Production server"},{"url":"https://events.decentraland.zone/api","description":"Development server"},{"url":"http://localhost:4000/api","description":"Local development server"}],"security":[],"paths":{"/profiles/me/settings":{"patch":{"tags":["Profile Settings"],"summary":"Update my profile settings","description":"Updates the authenticated user's profile settings (email, notifications, etc.).\n","operationId":"updateMyProfileSettings","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Schema for updating own profile settings","properties":{"email":{"type":"string","format":"email","description":"Update email address"},"email_verified":{"type":"boolean","description":"Mark email as verified (admin only)"},"use_local_time":{"type":"boolean"},"notify_by_email":{"type":"boolean"},"notify_by_browser":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Settings updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","description":"User profile settings and preferences","properties":{"user":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User's Ethereum address"},"email":{"type":"string","format":"email","nullable":true,"description":"User's email address"},"email_verified":{"type":"boolean","description":"Whether the email has been verified"},"email_verified_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was verified"},"email_updated_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was last updated"},"use_local_time":{"type":"boolean","description":"Whether to display times in local timezone","default":true},"notify_by_email":{"type":"boolean","description":"Whether to send email notifications","default":false},"notify_by_browser":{"type":"boolean","description":"Whether to send browser push notifications (deprecated)","default":false},"permissions":{"type":"array","description":"User's special permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile","test_any_notification"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["user"]}}}}}},"400":{"description":"Bad request - invalid parameters or body","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"401":{"description":"Unauthorized - authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}}}}}}}
```
## Get profile settings by address
> Returns profile settings for a specific user (admin only).\
> Requires authentication and edit\_any\_profile permission.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Events API","version":"1.0.0"},"tags":[{"name":"Profile Settings","description":"User profile settings including email preferences, notification settings,\nand administrative permissions.\n"}],"servers":[{"url":"https://events.decentraland.org/api","description":"Production server"},{"url":"https://events.decentraland.zone/api","description":"Development server"},{"url":"http://localhost:4000/api","description":"Local development server"}],"security":[],"paths":{"/profiles/{profile_id}/settings":{"get":{"tags":["Profile Settings"],"summary":"Get profile settings by address","description":"Returns profile settings for a specific user (admin only).\nRequires authentication and edit_any_profile permission.\n","operationId":"getProfileSettings","parameters":[{"name":"profile_id","in":"path","required":true,"description":"Ethereum address of the user","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"responses":{"200":{"description":"Profile settings","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","description":"User profile settings and preferences","properties":{"user":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User's Ethereum address"},"email":{"type":"string","format":"email","nullable":true,"description":"User's email address"},"email_verified":{"type":"boolean","description":"Whether the email has been verified"},"email_verified_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was verified"},"email_updated_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was last updated"},"use_local_time":{"type":"boolean","description":"Whether to display times in local timezone","default":true},"notify_by_email":{"type":"boolean","description":"Whether to send email notifications","default":false},"notify_by_browser":{"type":"boolean","description":"Whether to send browser push notifications (deprecated)","default":false},"permissions":{"type":"array","description":"User's special permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile","test_any_notification"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["user"]}}}}}},"401":{"description":"Unauthorized - authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"403":{"description":"Forbidden - insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"404":{"description":"Not found - resource doesn't exist","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}}}}}}}
```
## Update profile settings
> Updates permissions for a specific user (admin only).\
> Requires authentication and edit\_any\_profile permission.
```json
{"openapi":"3.0.3","info":{"title":"Decentraland Events API","version":"1.0.0"},"tags":[{"name":"Profile Settings","description":"User profile settings including email preferences, notification settings,\nand administrative permissions.\n"}],"servers":[{"url":"https://events.decentraland.org/api","description":"Production server"},{"url":"https://events.decentraland.zone/api","description":"Development server"},{"url":"http://localhost:4000/api","description":"Local development server"}],"security":[],"paths":{"/profiles/{profile_id}/settings":{"patch":{"tags":["Profile Settings"],"summary":"Update profile settings","description":"Updates permissions for a specific user (admin only).\nRequires authentication and edit_any_profile permission.\n","operationId":"updateProfileSettings","parameters":[{"name":"profile_id","in":"path","required":true,"description":"Ethereum address of the user","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Schema for updating another user's profile settings (admin only)","properties":{"permissions":{"type":"array","description":"Update user permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile"]}}}}}}},"responses":{"200":{"description":"Settings updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","description":"User profile settings and preferences","properties":{"user":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User's Ethereum address"},"email":{"type":"string","format":"email","nullable":true,"description":"User's email address"},"email_verified":{"type":"boolean","description":"Whether the email has been verified"},"email_verified_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was verified"},"email_updated_at":{"type":"string","format":"date-time","nullable":true,"description":"When the email was last updated"},"use_local_time":{"type":"boolean","description":"Whether to display times in local timezone","default":true},"notify_by_email":{"type":"boolean","description":"Whether to send email notifications","default":false},"notify_by_browser":{"type":"boolean","description":"Whether to send browser push notifications (deprecated)","default":false},"permissions":{"type":"array","description":"User's special permissions","items":{"type":"string","enum":["approve_own_event","approve_any_event","edit_any_event","edit_any_schedule","edit_any_profile","test_any_notification"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["user"]}}}}}},"400":{"description":"Bad request - invalid parameters or body","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"401":{"description":"Unauthorized - authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"403":{"description":"Forbidden - insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"404":{"description":"Not found - resource doesn't exist","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string","description":"Error message"}},"required":["ok","error"]}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.decentraland.org/apis/apis/events/profile-settings.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.