Artikelentwurf erstellen

Erstellt einen offenen Entwurf für einen Artikel. Änderungen bleiben im Entwurf, bis er veröffentlicht wird.

POST /v1/articles/{id}/drafts

Bearer-Token Scope content:write

curl 'https://api.ferndesk.com/v1/articles/art_01JXY9AZK4KV/drafts' \
  --request POST \
  --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.",
  "language": "fr"
}'

{
  "id": "drft_01JXY9AZK4KV",
  "language": "en",
  "status": "open",
  "baseVersion": 3,
  "source": "api",
  "stale": false,
  "updatedAt": "2026-01-15T18:25:43.511Z"
}

Entwurf erstellt

Pfadparameter

· 1

id string erforderlich

Kennung der angeforderten Ressource.

Body

erforderlich application/json

title string · min length: 1

Titel, der als Entwurf gespeichert werden soll.

content any

Inhalt als Tiptap-Dokument; nicht zusammen mit markdown zulässig.

markdown string

Inhalt als Markdown; nicht zusammen mit content zulässig.

language string · min length: 2· max length: 16

Sprache, für die eine Übersetzung als Entwurf erstellt werden soll; für die Standardsprache weglassen.

Pfadparameter

Body

Antworten