> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Members API: Provision, Suspend, and Remove Members

> List, provision, suspend, reinstate, and remove organization members with the OneCLI API, and see which groups each member is in.

Members are the people in your organization directory. These endpoints let you list them, create members by email without an invitation, suspend or reinstate them, and remove them.

For identity provider sync, use [SCIM](https://onecli.sh/docs/api-reference/scim). For an overview of onboarding options, see [User provisioning](https://onecli.sh/docs/guides/user-provisioning.md).

## Related guides

* [User provisioning: onboard and offboard people](https://onecli.sh/docs/guides/user-provisioning.md)
* [Agent access: control what members' agents can use](https://onecli.sh/docs/guides/agent-access.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [List members](https://onecli.sh/docs/api-reference/members/list-members.md) | `GET /org/members` | List your organization's members with cursor pagination. |
| [Provision a member](https://onecli.sh/docs/api-reference/members/provision-a-member.md) | `POST /org/members` | Provision a member by email without an invitation. |
| [Suspend, reinstate, or SSO-exempt a member](https://onecli.sh/docs/api-reference/members/suspend-reinstate-or-sso-exempt-a-member.md) | `PATCH /org/members/{userId}` | Suspend, reinstate, or SSO-exempt a member, one change per request. |
| [Remove a member](https://onecli.sh/docs/api-reference/members/remove-a-member.md) | `DELETE /org/members/{userId}` | Remove a member for good. |
| [List a member's groups](https://onecli.sh/docs/api-reference/members/list-a-members-groups.md) | `GET /org/members/{userId}/groups` | List the directory groups a member belongs to. |

## Next steps

* [API overview](https://onecli.sh/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](https://onecli.sh/docs/api-reference/errors.md): status codes and the error format
* [Editions](https://onecli.sh/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.