Ferndesk

Artikel

Einen Artikel aus dem Papierkorb wiederherstellen

Stellt einen Artikel aus dem Papierkorb wieder auf den Status zurück, den er vor dem Verschieben in den Papierkorb hatte. Erfordert den content:write-Scope; wenn der Artikel beim Verschieben in den Papierkorb den Status PUBLISHED hatte, bringt die Wiederherstellung den Live-Inhalt wieder online und erfordert zusätzlich content:publish.

Erforderlicher Scope: content:write

POST /articles/{id}/restore

Einen Artikel aus dem Papierkorb wiederherstellen

curl --request POST \
  --url 'https://api.ferndesk.com/v1/articles/{ID}/restore' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "<string>",
  "status": "<string>"
}

Wiederhergestellt

Authorizations

  • Authorization string erforderlich header

    Alle Anfragen erfordern ein Bearer-Token im Authorization-Header. API-Schlüssel beginnen mit fdsk_ und sollten geheim gehalten werden. Sie können Schlüssel über die Seite Entwicklereinstellungen generieren und verwalten.

    Schlüssel können auf eine beliebige Teilmenge dieser Scopes beschränkt werden (jeder Endpunkt führt den erforderlichen Scope über x-required-scopes auf):

    • content:read: Hilfecenter-Artikel, Sammlungen, Abschnitte und Übersetzungen lesen und durchsuchen
    • content:write: Artikelentwürfe, Benutzer und Aufgaben erstellen und bearbeiten; Artikel und Sammlungen verschieben
    • content:publish: Inhalte veröffentlichen, deren Veröffentlichung aufheben, wiederherstellen und in den Papierkorb verschieben (Änderungen live schalten)
    • analytics:read: Berichte, Analysen und Artikel-Feedback des Hilfecenters lesen
    • conversations:read: Unterhaltungen und Transkripte des KI-Assistenten lesen
    • webhooks:manage: Ausgehende Webhook-Abonnements erstellen und verwalten

    Die Vergabe von content:write oder content:publish beinhaltet content:read. Schlüssel, die vor der Einführung von Scopes erstellt wurden, haben null Scopes = vollständiger Zugriff (Legacy-Modus).

Path Parameters

  • id string erforderlich

    Ressourcen-ID der angeforderten Entität. Beispiel: art_01JXY9AZK4KV

Response

application/json
  • id string

    Ferndesk article ID (art_...).

  • status string

    Status nach der Wiederherstellung.