---
title: "Pause or resume anonymous access to an owned node's public shares"
method: POST
path: "/api/nodes/{node_id}/hosted-disabled"
tags: ["nodes"]
---

# Pause or resume anonymous access to an owned node's public shares

`POST /api/nodes/{node_id}/hosted-disabled`

## Request

- Base URL: `https://app.nerdit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.nerdit.ai/api/nodes/{node_id}/hosted-disabled`
- Auth: none declared

Flip the takedown switch, then end the streams it just de-authorized.

The column is the whole mechanism (D-HC-9): the public choke point reads
it on every request and the sweep reads it every pass, so the switch is
already effective the moment this transaction commits. Terminating the
live streams is what makes it effective *now* rather than at the end of
whatever an anonymous visitor is currently streaming — and it happens
after the commit, for the reason unlink closes its streams after its
own: a ``close_stream`` frame outlives the rollback of the transaction
that sent it, so a transaction that might still roll back must not send
one.

Only the anonymous streams (:meth:`ActiveStreamRegistry.by_hosted_node`)
— never the owner's own dashboard or share session on the same node.
Resuming ends nothing: there is nothing de-authorized to end.

## Path parameters

- `node_id` string, uuid, required

## Request body

- HostedDisabledRequest: The owner's takedown switch, in both directions.
  - `disabled` boolean, required

## Response `200`

Successful Response

- HostedDisabledView: The switch as it now stands — the state, never the transition.
  - `node_id` string, uuid, required
  - `hosted_disabled` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Error

---

[API](https://skmtc.dev/nerdit/apis/nerdit-cloud-web.md) · [All operations](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/llms.txt) · [OpenAPI document](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/revisions/06e3b44b58be?raw)