---
title: "Replace Pool Members"
method: PUT
path: "/resources/{resource_id}/pool_members"
tags: ["Pool Members"]
---

# Replace Pool Members

`PUT /resources/{resource_id}/pool_members`

Replaces the Resource's entire membership list with the given Clients.

Any Client not named in the request is removed from the pool. To add or
remove individual Clients without disturbing the rest, use `PATCH`.

## Path parameters

- `resource_id` string, required

## Request body

- PoolMemberPutRequest — PUT body replacing the pool's entire membership. Any Client not named here is removed from the pool.
  - `pool_members` object[], required
    - `device_id` string, uuid, required — Client ID

## Response `200`

Pool Member Response

- PoolMemberResponse — Response schema for Pool Member updates
  - `data` object — Pool members
    - `device_ids` string[] — Client IDs currently in the pool

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Content
- `429` — Too Many Requests

---

[API](https://skmtc.dev/firezone/apis/firezone-api.md) · [All operations](https://skmtc.dev/firezone/apis/firezone-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firezone/firezone-api/revisions/110de2cb2283/schema)