## cohorts/members

`GET /v1/cohorts/members`

Replace a cohort's member list in one call. Sweeps already completed keep the results they produced.

*Replace a cohort's members*

| Parameter | Required | Description |
| --- | --- | --- |
| `cohort_id` | yes | Cohort id (the {cohortId} path segment) — e.g. `coh_0f2c8b1d4e6a7c9b0d1e2f3a` |
| `members` | yes | The new member list, replacing the old one entirely: a comma-separated platform:identifier list, or a JSON array of {"platform","identifier"} objects. 1-100 members; every platform must exist in the catalogue. — e.g. `reddit:rust,hackernews:steveklabnik,github:rust-lang/rust` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/cohorts/members?cohort_id=coh_0f2c8b1d4e6a7c9b0d1e2f3a&members=reddit%3Arust%2Chackernews%3Asteveklabnik%2Cgithub%3Arust-lang%2Frust" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "id": null,
  "name": null,
  "created_at": null,
  "member_count": 0,
  "sweepable_count": 0,
  "members": [],
  "replaced": false
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/cohorts/members#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/cohorts/members.json)