Knowledge base

List folders

All folders, provides the IDs for folder_id.

GEThttps://app.elunos.ai/api/v1/knowledge/folders

Folders structure the knowledge base. That way an agent gets only the knowledge it needs in the conversation instead of the whole collection. This list is the easiest way to find the right folder_id for a document.

Query parameters

pageinteger

Page, starting at 1. Default 1.

per_pageinteger

Entries per page, maximum 100.

Example

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

Response

{
  "data": [
    {
      "id": "019f94f8-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
      "name": "Öffnungszeiten und Anfahrt",
      "parent_id": null,
      "documents_count": 4,
      "sync_status": "synced",
      "sync_error": null,
      "created_at": "2026-09-01T08:55:00+02:00",
      "updated_at": "2026-09-01T08:55:00+02:00"
    }
  ],
  "links": {
    "first": "https://app.elunos.ai/api/v1/knowledge/folders?page=1",
    "last": "https://app.elunos.ai/api/v1/knowledge/folders?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 50,
    "total": 1
  }
}

parent_id is the parent folder, documents_count the number of documents in it.