Favorites

User favorite management (requires authentication). Users can save their favorite places for quick access.

Add/remove place from favorites 🔒

patch

https://places.decentraland.org/apihttp://localhost:4000/api

/places/{place_id}/favorites

Add or remove a place from the authenticated user's favorites list.

Idempotent: Calling this endpoint with the same favorite status multiple times has the same effect as calling it once.

Returns updated favorite count for the place and current user status.

Authorizations

BearerAuth

AuthorizationstringRequired

Decentraland authentication token obtained from the Decentraland SDK or auth services.

To authenticate:

1. Use Decentraland's authentication SDK in your application
2. Get the auth token from the SDK
3. Include in requests: Authorization: Bearer <token>

Path parameters

place_idstring · uuidRequired

UUID of the place

Body

application/json

favoritesbooleanRequired

Set to true to add place to favorites, false to remove. Idempotent - safe to call multiple times.

Example: true

Responses

200

Favorite status updated successfully

application/json

okbooleanOptionalExample: true

401

Unauthorized - Missing or invalid authentication token

application/json

404

Resource not found - Place/world doesn't exist or is disabled

application/json

patch/places/{place_id}/favorites

HTTPcURLJavaScriptPython

PATCH /api/places/{place_id}/favorites HTTP/1.1
Host: places.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "favorites": true
}

Add to favoritesRemove from favorites

{
  "ok": true,
  "data": {
    "favorites": 13,
    "user_favorite": true
  }
}