Ferndesk

Artikel

Artikel aktualisieren

Aktualisiert einen bestehenden Help Center-Artikel. Inhaltsänderungen (Titel, Untertitel, Textkörper) erstellen und veröffentlichen automatisch eine neue Revision. Änderungen, die nur Metadaten betreffen (Slug, SEO-Felder, Kollektion), werden direkt angewendet.

Externe Artikel, die über Integrationen verwaltet werden, können nicht über diesen Endpunkt aktualisiert werden.

PATCH /articles/{id}

Artikel aktualisieren

curl --request PATCH \
  --url 'https://api.ferndesk.com/v1/articles/{ID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "id": "<string>",
  "title": "<string>",
  "contentHtml": "<string>",
  "url": "<url>",
  "sectionId": "<string>",
  "collectionId": "<string>",
  "status": "<string>",
  "publishedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Aktualisierter Artikel

Authorizations

  • Authorization string erforderlich header

    Alle Anfragen erfordern ein Bearer-Token im Authorization-Header. API-Keys beginnen mit dem Präfix fdsk_ und sollten geheim gehalten werden. Sie können Keys auf der Seite Entwickler-Einstellungen generieren und verwalten.

Path Parameters

  • id string erforderlich

    Ressourcen-ID für die angeforderte Entität. Beispiel: art_01JXY9AZK4KV

Request Body

application/json
  • title string

    Aktualisierter Artikeltitel.

  • subtitle string | null

    Aktualisierter Artikeluntertitel.

  • content any

    Aktualisierter Artikelinhalt.

  • collectionId string | null

    Aktualisierte Kollektionszuordnung.

  • keywords string

    Aktualisierte SEO-Keywords.

  • metaDescription string

    Aktualisierte SEO-Metabeschreibung.

  • ogImage string

    Aktualisierte Open Graph-Bild-URL.

  • slug string

    Aktualisierter benutzerdefinierter Slug. Wenn dieser vom bestehenden Slug abweicht, wird der Modus für benutzerdefinierte Slugs aktiviert.

Response

application/json
  • id string

    Ferndesk Artikel-ID (art_...).

  • title string

    Primärer Artikeltitel.

  • contentHtml string

    Artikelinhalt, gerendert als HTML.

  • url string (uri) | null

    Kanonische öffentliche URL für diesen Artikel.

  • sectionId string | null

    ID des Abschnitts, der den Artikel enthält.

  • collectionId string | null

    Optionale Kollektions-Gruppierungs-ID für den Artikel.

  • status string | null

    Veröffentlichungsstatus des Artikels.

  • publishedAt string | null

    Zeitstempel der Veröffentlichung des Artikels.

  • createdAt string

    ISO 8601 Zeitstempel in UTC.

  • updatedAt string

    ISO 8601 Zeitstempel in UTC.