# Users

## Filter users

 - [POST /users/filter](https://docs.mvmnt.io/apis/openapi/users/filterusers.md): Filter users using comprehensive query criteria with AND/OR logic and multiple operators.
Supports complex filtering similar to GraphQL capabilities.
Note: Soft-deleted users are excluded by default (deletedAt defaults to { isNull: true }).

## Create user

 - [POST /users](https://docs.mvmnt.io/apis/openapi/users/createuser.md): Create a new user in your organization

## Get user

 - [GET /users/{id}](https://docs.mvmnt.io/apis/openapi/users/getuser.md): Retrieve a user by ID or client key

## Update user

 - [PATCH /users/{id}](https://docs.mvmnt.io/apis/openapi/users/updateuser.md): Partially update a user. Only provided fields will be updated.

## Delete user

 - [DELETE /users/{id}](https://docs.mvmnt.io/apis/openapi/users/deleteuser.md): Soft delete a user (sets deletedAt timestamp)

## Search users

 - [POST /users/search](https://docs.mvmnt.io/apis/openapi/users/searchusers.md): Search users using OpenSearch-powered full-text and field-specific search.

This endpoint provides fast, indexed search across user data with support for:
- Full-text search across multiple fields
- Field-specific filtering with various operators
- Sorting and pagination
- Saved search preferences

Note: Only active (non-deleted) users are searchable. Soft-deleted records are automatically excluded from all search results.

Response Formats:
- flat (default): Returns indexed fields only for faster performance
- full: Returns complete user objects with all relationships