Update a Knowledge base name or description
curl --request PATCH \
--url https://api.langdock.com/knowledge/{folderId}/folder \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>"
}
'import requests
url = "https://api.langdock.com/knowledge/{folderId}/folder"
payload = {
"name": "<string>",
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', description: '<string>'})
};
fetch('https://api.langdock.com/knowledge/{folderId}/folder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.langdock.com/knowledge/{folderId}/folder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.langdock.com/knowledge/{folderId}/folder"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.langdock.com/knowledge/{folderId}/folder")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/knowledge/{folderId}/folder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyKnowledge Folder API
Wissensdatenbank aktualisieren
Benenne eine Wissensdatenbank um oder aktualisiere ihre Beschreibung
PATCH
/
knowledge
/
{folderId}
/
folder
Update a Knowledge base name or description
curl --request PATCH \
--url https://api.langdock.com/knowledge/{folderId}/folder \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>"
}
'import requests
url = "https://api.langdock.com/knowledge/{folderId}/folder"
payload = {
"name": "<string>",
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', description: '<string>'})
};
fetch('https://api.langdock.com/knowledge/{folderId}/folder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.langdock.com/knowledge/{folderId}/folder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.langdock.com/knowledge/{folderId}/folder"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.langdock.com/knowledge/{folderId}/folder")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/knowledge/{folderId}/folder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyAktualisiert Name oder Beschreibung einer bestehenden Wissensdatenbank. Das ist nicht der Endpoint zum Ersetzen einer Datei. Dateien ersetzt du mit Attachment in einer Wissensdatenbank aktualisieren.
Mindestens ein Feld muss gesetzt sein. Es gibt keinen öffentlichen Endpoint, um eine Wissensdatenbank zu erstellen oder zu löschen.
Bevor du startest
- API-Key-Scope: Erfordert einen API-Schlüssel mit dem
KNOWLEDGE_FOLDER_APIScope. Der API-Schlüssel selbst braucht die Rolle Bearbeiter auf der Wissensdatenbank. Siehe Wissensdatenbanken mit der API teilen für die Einrichtung. - Wissensdatenbanken: Die Knowledge Folder API verwaltet Ressourcen, die in der Library als Wissensdatenbanken erscheinen.
Basis-URL
https://api.langdock.com
Dedicated DeploymentsErsetze
api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.Anfrageformat
Dieser Endpoint erwartetapplication/json.
Pfadparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
folderId | string | Ja | Die ID der Wissensdatenbank |
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
name | string | Nein | Neuer Name. Nach dem Trimmen nicht leer. |
description | string | Nein | Neue Beschreibung. |
Beispiele
Aktualisieren mit cURL
curl -X PATCH "https://api.langdock.com/knowledge/{folderId}/folder" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Produkthandbuch",
"description": "Interne Produktdokumentation"
}'
Aktualisieren mit JavaScript
const axios = require("axios");
async function updateKnowledgeBase(folderId, data) {
const response = await axios.patch(
`https://api.langdock.com/knowledge/${folderId}/folder`,
data,
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
}
);
return response.data;
}
const result = await updateKnowledgeBase(
"550e8400-e29b-41d4-a716-446655440000",
{ name: "Produkthandbuch" }
);
console.log("Updated:", result.result.name);
Antwortformat
Erfolgreiche Antwort (200 OK)
{
status: "success";
result: {
id: string;
name: string;
description: string | null;
createdAt: string;
updatedAt: string;
};
}
Beispielantwort
{
"status": "success",
"result": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Produkthandbuch",
"description": "Interne Produktdokumentation",
"createdAt": "2026-08-12T09:15:00.000Z",
"updatedAt": "2026-09-01T10:22:00.000Z"
}
}
Fehlerbehandlung
| Status | Bedeutung |
|---|---|
400 | Ungültiger Body, leerer Name oder kein Feld gesetzt |
401 | Ungültiger oder fehlender API-Schlüssel |
403 | Fehlender KNOWLEDGE_FOLDER_API Scope, oder der Schlüssel ist kein Bearbeiter dieser Wissensdatenbank |
404 | Wissensdatenbank nicht gefunden |
429 | Rate Limit überschritten |
500 | Unerwarteter Serverfehler |
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.
War diese Seite hilfreich?