Ferndesk

Tâches

Lister les tâches

Renvoie les tâches de votre organisation, de la plus récente à la plus ancienne, avec une pagination par curseur. Filtrez avec status. Nécessite le scope content:write.

Scope requis : content:write

GET /tasks

Lister les tâches

curl --request GET \
  --url 'https://api.ferndesk.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "results": [
    {
      "id": "<string>",
      "title": "<string>",
      "status": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Tâches paginées par curseur

Authorizations

  • Authorization string requis header

    Toutes les requêtes nécessitent un jeton Bearer dans l’en-tête Authorization. Les clés API sont préfixées par fdsk_ et doivent rester secrètes. Vous pouvez générer et gérer les clés depuis la page Developer settings.

    Les clés peuvent être limitées à n’importe quel sous-ensemble de ces scopes (chaque endpoint indique le scope requis via x-required-scopes) :

    • content:read : Lire et rechercher les articles, collections, sections et traductions du centre d’aide
    • content:write : Créer et modifier des brouillons d’articles et des utilisateurs et tâches ; déplacer des articles et des collections
    • content:publish : Publier, dépublier, restaurer et mettre à la corbeille du contenu (rendre les modifications visibles)
    • analytics:read : Lire les rapports, analyses et retours sur les articles du centre d’aide
    • conversations:read : Lire les conversations et transcriptions de l’assistant IA
    • webhooks:manage : Créer et gérer les abonnements aux webhooks sortants

    Accorder content:write ou content:publish implique content:read. Les clés créées avant la mise en place des scopes ont des scopes null = accès complet (mode hérité).

Query Parameters

  • page_size integer

    Nombre d’éléments à renvoyer par page (1-100). Exemple: 20

  • start_cursor string

    Curseur de pagination opaque. Transmettez le next_cursor d’une réponse précédente pour récupérer la page suivante. Exemple: eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ

  • status string

    Filtrer par statut de tâche. Exemple: completed

Response

application/json
  • results[] object array

    Éléments de cette page. Données de la tâche.

    + Show Child Attributes
    • id string

      ID de la tâche (tsk_...).

    • title string | null

      Titre de la tâche. S’il est omis lors de la création, Fern en génère un après la création de la tâche.

    • status string

      Statut de traitement de la tâche.

  • has_more boolean

    Indique si d’autres éléments sont disponibles après cette page.

  • next_cursor string | null

    Curseur à transmettre comme start_cursor pour la page suivante, ou null sur la dernière page.