Knowledge API

Go to Project Settings → API Keys in the Jamdesk dashboard. Click Generate Key, give it a name, and copy the key — it starts with jdk_ and is only shown once.

Send a POST request to /_knowledge/search on your docs subdomain:

curl -X POST https://your-project.jamdesk.app/_knowledge/search \
  -H "Authorization: Bearer jdk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I set up a custom domain?", "limit": 5}'

The response returns an array of matching passages with relevance scores and page metadata:

{
  "query": "How do I set up a custom domain?",
  "results": [
    {
      "score": 0.94,
      "text": "To add a custom domain, go to Project Settings → Custom Domain...",
      "page": {
        "title": "Custom Domains",
        "path": "/deploy/custom-domains",
        "url": "https://your-project.jamdesk.app/deploy/custom-domains"
      }
    }
  ],
  "total": 1
}

In the Jamdesk dashboard, navigate to your project and click Settings.

Select the API Keys tab.

Click Generate Key, enter a descriptive name (e.g. "Intercom chatbot"), and click Create.

Copy the key immediately — it starts with jdk_ and is shown only once. Store it in your secrets manager or environment variables.