Zum Hauptinhalt springen
DELETE
/
attachment
/
v1
/
delete
Delete an attachment
curl --request DELETE \
  --url https://api.langdock.com/attachment/v1/delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "success": true,
  "message": "Attachment deleted successfully",
  "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/public
Lösche einen Anhang anhand seiner ID. Der Anhang muss zum gleichen Workspace wie der API-Schlüssel gehören und entweder vom Ersteller des API-Schlüssels erstellt worden sein oder zu einer Wissensdatenbank gehören, die mit dem API-Schlüssel geteilt ist.
Erfordert einen API-Schlüssel mit dem KNOWLEDGE_FOLDER_API Scope. Du kannst API-Schlüssel in deinen Workspace Einstellungen erstellen.

​
Anforderungsformat

Sende die Anhangs-ID im Request-Body als JSON.
ParameterTypErforderlichBeschreibung
attachmentIdstringJaDie UUID des zu löschenden Anhangs

​
Antwortformat

{
  success: true;
  message: string;
  attachmentId: string;
}

​
Beispiel

const axios = require("axios");

async function deleteAttachment(attachmentId) {
  const response = await axios.delete(
    "https://api.langdock.com/attachment/v1/delete",
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      data: { attachmentId },
    }
  );

  console.log(response.data);
  // {
  //   success: true,
  //   message: "Attachment deleted successfully",
  //   attachmentId: "550e8400-e29b-41d4-a716-446655440000"
  // }
}

​
Fehlerbehandlung

try {
  await deleteAttachment("550e8400-e29b-41d4-a716-446655440000");
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error("Ungültiger Request-Body:", error.response.data.message);
        break;
      case 401:
        console.error("Ungültiger API-Schlüssel");
        break;
      case 403:
        console.error("API-Schlüssel hat keinen Zugriff auf diesen Anhang");
        break;
      case 404:
        console.error("Anhang nicht gefunden");
        break;
      case 500:
        console.error("Server-Fehler");
        break;
    }
  }
}
Ein gelöschter Anhang kann nicht mehr in Agent-Konversationen referenziert oder über die API wiederhergestellt werden.
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.

Autorisierungen

​
Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Body

application/json
​
attachmentId
string<uuid>
erforderlich

The ID of the attachment to delete

Antwort

Attachment deleted successfully

​
success
boolean
erforderlich
Beispiel:

true

​
message
string
erforderlich
Beispiel:

"Attachment deleted successfully"

​
attachmentId
string<uuid>
erforderlich

The ID of the deleted attachment