---
title: "Enable or update a node's public link sharing"
method: POST
path: "/api/v1/nodes/{nodeId}/share"
tags: ["Nodes", "Sharing"]
---

# Enable or update a node's public link sharing

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

## Request

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

## Path parameters

- `nodeId` string, required

## Request body

- object
  - `scope` 'none' | 'public', required
  - `capability` 'read' | 'submit'
  - `password` string
  - `expiresAt` string, date-time

## Response `200`

Turned public sharing on (or updated its capability/password/expiry) and re-materialized the effective public scope down the subtree. Requires `manage` level on the node.

- object
  - `nodeId` string, required
  - `scope` 'none' | 'public', required
  - `capability` 'read' | 'submit', required
  - `hasPassword` boolean, required
  - `expiresAt` string, required
  - `updatedAt` string, 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)