# Kandji

## Connection Requirements

{% stepper %}
{% step %}

### IP or Domain

Enter the domain or IP of your Kandji instance. This is the URL where the service is hosted.

{% hint style="info" %}
api.kandji.io\
For most users, the default domain is api.kandji.io
{% endhint %}
{% endstep %}

{% step %}

### Token

You need to generate an API token to establish a connection. Follow these steps to create a Token:

* Log in and click on Settings.
* Click the Access tab.
* Click the Add API Token button to create a new API key.
* Provide a Name and a Description for your API token and click Create.
* Kandji will display a modal with the API token. Click the visibility symbol to expose it or use the Copy Token button to copy the API token to your clipboard, storing it in a safe place. Note: You will not be able to see the token details again.
* Click Next.
* Click Configure to manage the API permissions for this specific token or Skip to change them later.
* After making your modifications, click Save.
* Once you create your first token, you will see your tenant-specific API URL.
  {% endstep %}

{% step %}

### Proxy

Proxy URL. (optional)
{% endstep %}

{% step %}

### SSL

Choose whether to use SSL for a secure connection. This is optional, but by default, connections are encrypted.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}


---

# 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://docs.octoxlabs.com/adapters/adapters/kandji.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.