Artikel aktualisieren

Aktualisiert einen Artikel. Metadaten und Platzierung werden sofort angewendet; Inhaltsänderungen werden in einem offenen Entwurf zwischengespeichert, den Sie separat veröffentlichen.

PATCH /v1/articles/{id}

Bearer-Token Scope content:write

curl 'https://api.ferndesk.com/v1/articles/art_01JXY9AZK4KV' \
  --request PATCH \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Getting started with API keys",
  "content": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "content": [
          {
            "type": "text",
            "text": "Welcome to Ferndesk."
          }
        ]
      }
    ]
  },
  "markdown": "# Getting started\n\nWelcome to the API.",
  "collectionId": "col_01JXYA6ABN52",
  "sectionId": "sect_01JXYA4T1JNT",
  "keywords": "api, auth, keys",
  "metaDescription": "Learn how to create and rotate Ferndesk API keys.",
  "ogImage": "https://cdn.ferndesk.com/og/getting-started.png",
  "listed": "unlisted",
  "noindex": false,
  "layout": "full",
  "slug": "getting-started-api-keys"
}'

{
  "id": "art_01JXY9AZK4KV",
  "title": "Getting started with API keys",
  "slug": "getting-started-api-keys",
  "contentHtml": "<p>Welcome to the Ferndesk API.</p>",
  "contentMarkdown": "# Welcome to the Ferndesk API",
  "contentJson": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "content": [
          {
            "type": "text",
            "text": "Welcome to Ferndesk."
          }
        ]
      }
    ]
  },
  "url": "https://docs.example.com/getting-started-api-keys-A1B2C3",
  "sectionId": "sect_01JXYA4T1JNT",
  "collectionId": "col_01JXYA6ABN52",
  "status": "published",
  "layout": "default",
  "publishedAt": "2026-01-15T18:25:43.511Z",
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z",
  "published": false,
  "draft_id": "drft_01JXY9AZK4KV",
  "message": "Content staged in draft drft_01JXY9AZK4KV; placement applied."
}

Aktualisierter Artikel

Pfadparameter

· 1

id string erforderlich

Bezeichner der angeforderten Ressource.

Body

erforderlich application/json

title string · min length: 1

Neuer Titel, in einem offenen Entwurf zwischengespeichert.

content any

Neuer Inhalt als Tiptap-Dokument, in einem offenen Entwurf zwischengespeichert; kann nicht zusammen mit markdown verwendet werden.

markdown string

Neuer Inhalt als Markdown, in einem offenen Entwurf zwischengespeichert; kann nicht zusammen mit content verwendet werden.

collectionId string | null

Sammlung, unter der der Artikel abgelegt wird; wird sofort angewendet.

sectionId string

Abschnitt, unter dem der Artikel abgelegt wird; wird sofort angewendet.

keywords string

Durch Kommas getrennte SEO-Schlüsselwörter.

metaDescription string

SEO-Meta-Beschreibung.

ogImage string

Open-Graph-Bild-URL.

Pfadparameter

Body

Antworten