Quickstart

This guide gets you from nothing to your first answer in a couple of minutes. You will create a token, confirm it works, and run a search.

If you would rather connect an AI assistant instead of writing code, see Connect Claude Code instead. It uses the same token.

1. Create a personal access token

   In the Mereon app, open Profile → API Tokens and create a token. Give it a name you will recognize later, like “Claude on my laptop”.

   Copy the token when it appears. It is shown once, at creation, and looks like this:

   mrn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

   Treat it like a password

   Anyone with this token can read whatever you can read in Mereon. Store it in a password manager or a secrets file, never in shared chat or committed code. You can revoke it any time from the same screen.

2. Save it as an environment variable

   So the examples below work as written, put your token in a variable:

   export MEREON_TOKEN="mrn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

3. Confirm it works

   The /v1/me endpoint tells you who the token belongs to. If you get a JSON response back, you are connected.

   curl

   curl https://api.mereon.ai/v1/me \
     -H "Authorization: Bearer $MEREON_TOKEN"

   JavaScript

   const res = await fetch('https://api.mereon.ai/v1/me', {
     headers: { Authorization: `Bearer ${process.env.MEREON_TOKEN}` },
   });
   console.log(await res.json());

   Python

   import os, requests
   
   res = requests.get(
       "https://api.mereon.ai/v1/me",
       headers={"Authorization": f"Bearer {os.environ['MEREON_TOKEN']}"},
   )
   print(res.json())

   You should see your user and organization:

   {
     "user": { "id": "usr_...", "name": "Alex Doe", "email": "[email protected]" },
     "organization": { "id": "org_...", "name": "Acme Inc" },
     "token": {
       "name": "Claude on my laptop",
       "tokenPrefix": "mrn_xxxx",
       "scopes": ["read"],
       "expiresAt": "2026-09-15T00:00:00.000Z"
     }
   }

4. Run your first search

   Search runs across your knowledge topics and the text of your source documents and transcripts. Results come back ordered by relevance, each with a link into Mereon.

   curl

   curl "https://api.mereon.ai/v1/search?q=expense+approval&limit=5" \
     -H "Authorization: Bearer $MEREON_TOKEN"

   JavaScript

   const params = new URLSearchParams({ q: 'expense approval', limit: '5' });
   const res = await fetch(`https://api.mereon.ai/v1/search?${params}`, {
     headers: { Authorization: `Bearer ${process.env.MEREON_TOKEN}` },
   });
   const { data } = await res.json();
   for (const hit of data) console.log(hit.title, hit.url);

   Python

   import os, requests
   
   res = requests.get(
       "https://api.mereon.ai/v1/search",
       params={"q": "expense approval", "limit": 5},
       headers={"Authorization": f"Bearer {os.environ['MEREON_TOKEN']}"},
   )
   for hit in res.json()["data"]:
       print(hit["title"], hit["url"])

Where to go next

• Authentication covers token expiry, multiple organizations, and what your admin can control.
• How Mereon is organized explains topics, items, evidence, and duties so the responses make sense.
• The API reference documents every endpoint with request and response examples.
• Prefer to skip the code? Connect Claude Code and let the assistant call these endpoints for you.