How to use the Navōn developer API with your own key
Make a key, send a first request and see what a refusal looks like. A plain guide to Navōn's developer API.

Navōn has an API for people who want to build their own tool on top of it: a class helper bot, a homework page for a school, a small script that drafts worksheets. The API runs the same filter as the app, so what your tool shows is held to the same standard as Navōn itself. This guide covers the first steps: making a key, sending a first request, and what to expect when Navōn refuses something. It assumes you are comfortable running a small piece of code, or can ask someone who is.
What the API is for
The API is a developer feature. It speaks the same request and reply shape as OpenAI's chat API, so most existing code and the OpenAI libraries work once you change two things: the base address and the key. Every question is checked before it reaches a model, and every answer is checked before it reaches you. A key acts for your account, so your filter settings apply to it as well.
Who can have a key
Keys are for approved adult accounts on a paid plan. Accounts supervised by a parent or a school cannot hold keys, because a key would carry the account outside what the parent or school can see. If your account does not qualify, the API keys page says why instead of showing the key list. If you hold keys and your account later stops qualifying, the page tells you your keys are paused.
Make a key
- Go to navon.org/developers/keys. You can also open the Developers page at navon.org/developers and press Get an API key.
- Press New key. A box opens asking for a name. Use something that tells you where the key will live, such as "Class helper bot". Names can be up to 60 characters.
- Press Make key. Your new key appears in the box, once.
- Copy it with the Copy button and store it somewhere safe. The Done button stays locked, and reads "Copy it first", until you have copied the key. Navōn does not show the key again.
- Press Done. The key now appears in your list with its first few characters, the date it was made and when it was last used.
You can have up to ten active keys at a time. A separate key for each tool is a good habit, because you can switch one off without touching the rest.
Send a first request
Send the key from your own server, as a header that reads Authorization: Bearer followed by the key. The base address is https://api.navon.org/functions/v1/api/v1, and the main route is /chat/completions. The Developers page has working examples in curl, Python and JavaScript that you can copy. In the examples the key is read from an environment variable called NAVON_API_KEY, which keeps it out of your code.
For the model, you can send "auto" and let Navōn choose one for each question. The reply then says which model answered. Or you can name a model from the list on the Developers page. To see exactly which models your own key can use, ask the /models route.
Other routes are /images/generations, for a picture from a prompt, and /moderations, which checks text against your policy without generating anything and takes up to 20 inputs at a time. Streaming works on chat requests.
When Navōn refuses
A chat question that Navōn will not answer is not an error. It comes back as a normal reply with a finish reason of content_filter and a kind message your tool can show as it is. Each reply also carries a navon section that says whether anything was blocked, whether it was the question or the answer, and why. Streaming starts only after the answer has passed the check, so a withheld answer never arrives half written.
Images work differently. If the prompt or the picture does not meet the guidelines, the request returns an error. If the safety check cannot run at all, the request fails with a 503 and nothing is sent, so wait a few seconds and try again. This fails closed on purpose. Plan for a few seconds of checking on every request.
Watch your usage and revoke a key
Below your key list, the Usage panel covers the last 30 days. It shows how many requests were answered, how many were refused or withheld, the average response time, a small chart of the last fourteen days and a table of recent requests. Each row shows the key, the route, the model and the result.
To switch a key off, press the bin icon beside it and confirm Revoke. The key stops working straight away, and this cannot be undone. Revoke a key at once if it ends up somewhere it should not be, and make a new one.
Tips
- Keep the key on a server. Never put it in a web page or an app people download, because anyone who finds it can use Navōn as you.
- Each key is limited to 60 requests a minute, on top of your account's own limits. A 429 reply includes a Retry-After header telling you how long to wait.
- Use the /moderations route when you only want to check text, for example before posting a student's message.
- Show the refusal message to your users as it is. It is written to be kind and often suggests something else to ask.
What it will not do
The API does not remove the filter. There is no setting that lets a key bypass Navōn's standards, and a key never goes beyond what your account itself may do. It is also not a place for halachic rulings: for a shailah, send your user to a rav. For the larger picture of how Navōn approaches this, read the guide to kosher AI.
Common questions
Is the Navōn API compatible with the OpenAI libraries?
Yes for chat. It uses OpenAI's request and reply shape, so you change the base address and the key in the OpenAI library you already use. Streaming works too.
Who can make a Navōn API key?
An approved adult account on a paid plan. Accounts supervised by a parent or a school cannot hold keys.
How many API keys can I have?
Up to ten active keys at a time. You can revoke any key from the API keys page, and it stops working straight away.
What happens if the API refuses my question?
A refused chat question comes back as a normal reply with a finish reason of content_filter and a message your tool can show. A navon section in the reply says whether the question or the answer was stopped, and why.
Published by Navōn. How these guides are written and checked.
Read next
- How to set parental controls in Navōn: topics, time and alerts
A step-by-step guide to the Navōn Family Hub: set a safety level, block topics, limit daily time and hours, and choose how you are alerted.
- Kosher AI: what it means and how to evaluate it
A complete guide to what people mean by kosher AI, why no certification exists, and the specific properties to check before a tool enters your home or classroom.
- What is Navōn? The kosher AI platform, explained
What is Navōn? Navon, at navon.org, is a kosher AI platform for schools and families that checks every prompt and answer against standards you set.