---
title: "Toggle the current actor's favorite on a node"
method: POST
path: "/api/v1/nodes/{nodeId}/favorite"
tags: ["Nodes", "Favorites"]
---

# Toggle the current actor's favorite on a node

`POST /api/v1/nodes/{nodeId}/favorite`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/nodes/{nodeId}/favorite`
- Auth: none declared

## Path parameters

- `nodeId` string, required

## Response `200`

Upserted or deleted a row keyed by the (nodeId, actorId) unique pair — a true toggle, race-safe under a rapid double-click, never a duplicate. `favorited` reflects the node's new state for the acting user. Purely additive: never moves or hides the node from its real position in the Bases tree.

- object
  - `favorited` boolean, required

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)