Ferndesk

Aufgaben

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.\n\nRate limit: 10 Anfragen pro Stunde pro API-Key.

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>"
}

Erstellte Aufgabe

Authorizations

  • Authorization string erforderlich header

    Alle Anfragen erfordern ein Bearer-Token im Authorization-Header. API-Keys haben das Präfix fdsk_ und sollten geheim gehalten werden. Sie können Keys 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. Falls weggelassen, generiert Fern nach der Aufgabenerstellung einen Titel.

Response

application/json
  • id string

    Aufgaben-ID (tsk_...).

  • title string | null

    Aufgabentitel. Falls bei der Erstellung weggelassen, generiert Fern nach der Aufgabenerstellung einen Titel.

  • status string

    Status der Aufgabenverarbeitung.