コンテンツにスキップ

`POST /api/v1/pools/{name}/restore` — put a covered pool's members back.

POST
/api/v1/pools/{name}/restore
curl --request POST \
--url https://example.com/api/v1/pools/example/restore \
--header 'Authorization: Bearer <token>'

Each member returns to its own recorded assignment, which for an inheriting node means no assignment at all. Restoring them all to the pool’s name would pin rows that were never pinned, leaving a deployment the takeover never promised to be reversible about.

A member whose pool a person has since changed by hand keeps that change — a later human decision outranks this bookkeeping — but its record is dropped either way, so a pool cannot stay marked as covered forever.

Restoring is deliberately not automatic when the site’s poller returns: 22 nodes moving on their own the moment a link comes back is its own surprise (ADR-107 Inc.4, out of scope).

name
required
string

The pool that was being covered for

How many nodes and folders went back

Media typeapplication/json

What one call re-pointed.

object
folders
required

Folders re-pointed.

integer format: int64
nodes
required

Nodes re-pointed.

integer format: int64
Examplegenerated
{
"folders": 1,
"nodes": 1
}

Not a usable pool name

Not signed in

ManageSystem required

No admin state