---
title: "Add/remove place from favorites 🔒"
method: PATCH
path: "/places/{place_id}/favorites"
tags: ["Favorites"]
---

# Add/remove place from favorites 🔒

`PATCH /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.

## Path parameters

- `place_id` string, uuid, required

## Request body

- object
  - `favorites` boolean, required — Set to true to add place to favorites, false to remove. Idempotent - safe to call multiple times.

## Response `200`

Favorite status updated successfully

- object
  - `ok` boolean
  - `data` object
    - `favorites` integer — Updated total favorite count for the place
    - `user_favorite` boolean — Current user's favorite status

## Other responses

- `401` — Unauthorized - Missing or invalid authentication token
- `404` — Resource not found - Place/world doesn't exist or is disabled

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)