# GroupsManager
Reach these methods through the `groups` field on `client::Client`.
## list
`GET /groups`
| `filter_term` | query | `String` | no |
| `fields` | query | `Vec<String>` | no |
| `limit` | query | `i64` | no |
| `offset` | query | `i64` | no |
**Returns:** `Groups`
**Example**
```rust
let mut pages = client.groups.list(None);
while let Some(item) = pages.next().await {
// use item
}
```
Paginated — `list(...)` returns a paginator you drive with `.next().await`, threading the cursor for you. See the [pagination guide](../pagination.md).
## create
`POST /groups`
| `fields` | query | `Vec<String>` | no |
**Request body** (`application/json`): `GroupCreateRequest`
**Returns:** `GroupFull`
**Example**
```rust
let result = client.groups.create(schemas::GroupCreateRequest { /* … */ }, None).await?;
```
## get
`GET /groups/{group_id}`
| `group_id` | path | `String` | yes |
| `fields` | query | `Vec<String>` | no |
**Returns:** `GroupFull`
**Example**
```rust
let result = client.groups.get("GROUP_ID".to_string(), None).await?;
```
## update
`PUT /groups/{group_id}`
| `group_id` | path | `String` | yes |
| `fields` | query | `Vec<String>` | no |
**Request body** (`application/json`): `GroupUpdateRequest`
**Returns:** `GroupFull`
**Example**
```rust
let result = client.groups.update("GROUP_ID".to_string(), schemas::GroupUpdateRequest { /* … */ }, None).await?;
```
## delete
`DELETE /groups/{group_id}`
| `group_id` | path | `String` | yes |
**Returns:** no content
**Example**
```rust
client.groups.delete("GROUP_ID".to_string()).await?;
```