# Users

The users endpoints allows you to CRUD users within your Cal.com instance.

{% hint style="info" %}
The user endpoints can only be used on self-hosted enterprise instances and not on our hosted platform. Also note that these are ADMIN only API requests.
{% endhint %}

## Find all users

{% openapi src="<https://api.cal.com/api/docs>" path="/users" method="get" %}
<https://api.cal.com/api/docs>
{% endopenapi %}

## Find a user

{% openapi src="<https://api.cal.com/docs>" path="/users/{userId}" method="get" %}
<https://api.cal.com/docs>
{% endopenapi %}

## Edit an existing user

{% openapi src="<https://api.cal.com/api/docs>" path="/users/{userId}" method="patch" %}
<https://api.cal.com/api/docs>
{% endopenapi %}

## Remove an existing user

{% openapi src="<https://api.cal.com/api/docs>" path="/users/{userId}" method="delete" %}
<https://api.cal.com/api/docs>
{% endopenapi %}

### Create a new user

{% openapi src="<https://api.cal.com/api/docs>" path="/users" method="post" %}
<https://api.cal.com/api/docs>
{% endopenapi %}