# Hideez Enterprise Server web API

Almost everything you can do with the HES web interface you can do via the HES REST API calls.

Follow the `Quick Start` instructions:

The HES web API is intended to integrate the Hideez Authentication Service with the third party services. Using the API you can manage employees, devices, and credentials. Almost everything you can do with the HES web interface you can do via the HES REST API calls. To see the list of available methods, their parameters and return values you need to install your own HES instance and open the link: `https://<your_server_name>/swagger/` By this link, you will be able to test each method as well.\
To use web API calls from an external application or service you need to authorize first. Use `POST` method `https://<your_server_name>/api/Identity/LoginWithPassword` and send your login (email) and password in the json format:

```
{
    "email": "<user_email>",
    "password": "<user_password>"
}
```

Server response headers will contain cookie named '.AspNetCore.Identity.Application'. Add this cookie to the headers of each following request. Identity cookie is valid for two weeks after that you need to call `https://<your_server_name>/api/Identity/LoginWithPassword` method again.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://enterprise.hideez.com/api/hideez-enterprise-server-web-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.