Overview

Authentication

Create a key and send it with every request.

Every request needs a key. There are no sessions and no username and password login.

Create a key

In the platform under Settings → API keys, choose New key. This requires admin rights in the team.

The key is shown exactly once. Copy it straight away and keep it where you keep your other credentials. If it is lost, create a new one and delete the old one.

Sending it

The key goes into the Authorization header as a bearer token. Keys start with np_.

curl https://app.elunos.ai/api/v1/knowledge/documents \\
  -H "Authorization: Bearer np_xxxxxxxx"

Limits

60 requests per minute per key. Going over returns an error instead of an answer, so space out the calls in a bulk import.

The key belongs on a server, not in a web page or an app. Whoever holds it can read, change and delete all of your knowledge.