Skip to main content
GET
/
api
/
knowledge
/
knowledge-entries
List knowledge entries of the current tenant
curl --request GET \
  --url https://{tenant}.app.big-panda.ai/api/knowledge/knowledge-entries \
  --header 'Authorization: Bearer <token>'
[
  {
    "title": "<string>",
    "content": "<string>",
    "category_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "visibility": "public",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tenant_id": "<string>",
    "type": "knowledge",
    "version": 123,
    "language": "<string>",
    "translation_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source": "manual",
    "source_reference": "<string>",
    "embedding_model": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "summary": "<string>",
    "layer": "<string>",
    "tags": [
      "<string>"
    ],
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "metadata": {},
    "search_keywords": [
      "<string>"
    ]
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.big-panda.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API-Token aus dem Big-Panda-Admin-UI unter Einstellungen → API-Keys. Header: Authorization: Bearer <token>.

Headers

​
X-Scopes
string
default:""

Space-separated scope set from the token (ADR-015)

Query Parameters

​
category_id
string<uuid> | null

If set, only entries within this category are returned

​
type
enum<string> | null

If set, only entries of this discriminator type are returned (knowledge, skill, process, glossary, memory, bootstrap, skill_index). None = all types. Allowed values for the type discriminator (ADR-020).

Mirrors ALLOWED_TYPES in app/models/knowledge_entry.py and the DB CHECK constraint added in migration 0026. Each value selects a metadata-schema in app/schemas/entry_metadata.py.

Available options:
knowledge,
skill,
process,
glossary,
memory,
bootstrap,
skill_index
​
project_id
string<uuid> | null

If set, only entries linked to that project via project_members are returned (B.3).

​
visibility
enum<string> | null

If set, only entries with this visibility are returned Allowed values for the visibility field of a knowledge entry.

'personal' is ownership-gated (ADR-015 §3a): it exists in the enum so responses carrying it validate correctly, but write-side routes block it on the main path — personal entries are created via POST /knowledge-entries/personal only.

'workspace' (ROADMAP M.8) is the workspace-scoped visibility hook. Code accepts the value passively until tenants.workspaces_enabled is flipped on; today no read path filters by it.

Available options:
public,
internal,
personal,
restricted,
community,
workspace
​
layer
string | null

If set, only entries with this layer are returned

​
include_expired
boolean
default:false

If true, expired memory entries are included (Memory-Admin UI). Ceiling and personal-ownership remain enforced.

Response

Successful Response

​
title
string
required
Required string length: 1 - 500
​
content
string
required
Minimum string length: 1
​
category_id
string<uuid>
required
​
visibility
enum<string>
required

Allowed values for the visibility field of a knowledge entry.

'personal' is ownership-gated (ADR-015 §3a): it exists in the enum so responses carrying it validate correctly, but write-side routes block it on the main path — personal entries are created via POST /knowledge-entries/personal only.

'workspace' (ROADMAP M.8) is the workspace-scoped visibility hook. Code accepts the value passively until tenants.workspaces_enabled is flipped on; today no read path filters by it.

Available options:
public,
internal,
personal,
restricted,
community,
workspace
​
id
string<uuid>
required
​
tenant_id
string
required
​
type
enum<string>
required

Allowed values for the type discriminator (ADR-020).

Mirrors ALLOWED_TYPES in app/models/knowledge_entry.py and the DB CHECK constraint added in migration 0026. Each value selects a metadata-schema in app/schemas/entry_metadata.py.

Available options:
knowledge,
skill,
process,
glossary,
memory,
bootstrap,
skill_index
​
version
integer
required
​
language
string
required
​
translation_group_id
string<uuid>
required
​
source
enum<string>
required

Where a knowledge entry originated from.

Available options:
manual,
import,
conversational,
learning_loop,
system
​
source_reference
string | null
required
​
embedding_model
string | null
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
summary
string | null
​
layer
string | null
Maximum string length: 50
​
tags
string[]
​
workspace_id
string<uuid> | null
​
created_by_user_id
string<uuid> | null
​
metadata
Metadata · object
​
search_keywords
string[]