Ferndesk

Tasks

Aufgabe erstellen

Erstellt eine neue Aufgabe und reiht sie für die KI-Verarbeitung ein. Mit Aufgaben können Sie die KI von Ferndesk anweisen, Hilfeartikel basierend auf Ihrer Beschreibung zu erstellen oder zu aktualisieren. Ratenbegrenzung: 10 Anfragen pro Stunde pro API-Schlüssel.

POST /tasks

Aufgabe erstellen

curl --request POST \
  --url 'https://api.ferndesk.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "id": "<string>",
  "title": "<string>",
  "status": "<string>"
}

Aufgabe erstellt

Authorizations

  • Authorization string erforderlich header

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

Request Body

application/json
  • description string erforderlich

    Aufgabenbeschreibung, die erklärt, was erstellt oder aktualisiert werden soll.

  • title string

    Optionaler Aufgabentitel. Wird aus der Beschreibung abgeleitet, falls nicht angegeben.

Response

application/json
  • id string

    Aufgaben-ID (tsk_...).

  • title string | null

    Aufgabentitel. Wird bei der Erstellung aus der Beschreibung abgeleitet, falls nicht angegeben.

  • status string

    Status der Aufgabenverarbeitung.