> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-pool.md).

# /api/v1/pool

Manage **pools** — fylr's hierarchical containers for storage, permissions and metadata defaults. Pools form a tree; each pool can inherit ACL items and configuration from its parent.

Differs from easydb 5: a save that touches collection ACLs is confirmed with the `allow_invalid_acl` / `background_invalid_acl` / `background_invalid_acl_timelimit` query parameters instead of easydb 5's single `collection_rights_policy` parameter.

Differs from easydb 5: there is no separate `system.rights_management` right for updating rights-management attributes on the root pool — every save is gated on `system.poolmanager` (or `system.root`) plus the per-pool `bag_*` rights. (easydb 5 required `system.rights_management` for root-pool rights changes.)

### `GET /pool` — List all pools visible to the authenticated user.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /pool` — Create or update one or more pools.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `PUT /pool` — Create or update one or more pools (alias for POST).

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool" method="put" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /pool/{poolID}` — Retrieve a single pool by id.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool/{poolID}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `DELETE /pool/{poolID}` — Delete a pool by id.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool/{poolID}" method="delete" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /pool/{poolID}/stats` — Statistics for a single pool.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/pool/{poolID}/stats" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-d5aceac1c99d5aa0b623bea061400efbac147a8d%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}