# HeyDonto Authentication Documentation

API documentation for HeyDonto Authentication and User Management

Version: 1.0

## Servers

Sandbox
```
https://api-staging.heydonto.com
```

Production
```
https://api.heydonto.com
```

## Security

### bearer

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[HeyDonto Authentication Documentation](https://docs.heydonto.com/_bundle/apis/authentication/openapi.yaml)

## Users

### Retrieve all users with optional filters and pagination

 - [GET /users](https://docs.heydonto.com/apis/authentication/openapi/users/userscontroller_findusers.md)

### Create a new user

 - [POST /users](https://docs.heydonto.com/apis/authentication/openapi/users/userscontroller_createuser.md)

### Update a user

 - [PUT /users/{userId}](https://docs.heydonto.com/apis/authentication/openapi/users/userscontroller_updateuser.md)

### Delete a user

 - [DELETE /users/{userId}](https://docs.heydonto.com/apis/authentication/openapi/users/userscontroller_deleteuser.md)

### Resend invitation email to a user

 - [POST /users/{userId}/resend-invitation](https://docs.heydonto.com/apis/authentication/openapi/users/userscontroller_resendinvitation.md)

## Authentication

### Login to set authentication cookie or get JWT token for third-party integration

 - [POST /auth/login](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_login.md)

### Logout user and clear authentication cookie

 - [POST /auth/logout](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_logout.md)

### Get the currently authenticated user

 - [GET /auth/user](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_getcurrentuser.md)

### Confirm accepting terms of service

 - [POST /auth/tos-accept](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_accepttermsofservice.md)

### Send password reset email

 - [POST /auth/forgot-password](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_forgotpassword.md)

### Reset the password using a token

 - [POST /auth/reset-password](https://docs.heydonto.com/apis/authentication/openapi/authentication/authcontroller_resetpassword.md)

## Synchronizer Authentication

### Activate synchronizer with site license key

 - [POST /auth/synchronizer/activate](https://docs.heydonto.com/apis/authentication/openapi/synchronizer-authentication/synchronizerauthcontroller_activatesynchronizer.md): Exchange site license key for synchronizer-specific access tokens

### Refresh synchronizer tokens

 - [POST /auth/synchronizer/refresh](https://docs.heydonto.com/apis/authentication/openapi/synchronizer-authentication/synchronizerauthcontroller_refreshtokens.md): Exchange refresh token for new access tokens

### Deactivate synchronizer

 - [POST /auth/synchronizer/deactivate](https://docs.heydonto.com/apis/authentication/openapi/synchronizer-authentication/synchronizerauthcontroller_deactivatesynchronizer.md): Revoke all tokens and unregister synchronizer device

### Send synchronizer heartbeat

 - [POST /auth/synchronizer/heartbeat](https://docs.heydonto.com/apis/authentication/openapi/synchronizer-authentication/synchronizerauthcontroller_heartbeat.md): Report synchronizer health and metrics