Ferndesk

Révisions d’articles

Restaurer une révision d’article

Restaure une ancienne révision en la préparant comme un nouveau brouillon et en la publiant par-dessus la version actuelle (l’historique reste linéaire). Nécessite le scope content:publish.

Scope requis : content:publish

POST /articles/{id}/revisions/{revisionId}/restore

Restaurer une révision d’article

curl --request POST \
  --url 'https://api.ferndesk.com/v1/articles/{ID}/revisions/{REVISIONID}/restore' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "articleId": "<string>",
  "language": "<string>",
  "restoredFromVersion": 1,
  "newVersion": 1
}

Restauré

Authorizations

  • Authorization string requis header

    Toutes les requêtes nécessitent un Bearer token 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 Paramètres développeur.

    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, des utilisateurs et des tâches ; déplacer des articles et des collections
    • content:publish : Publier, dépublier, restaurer et supprimer du contenu (rendre les modifications accessibles)
    • 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

    L’attribution de content:write ou content:publish implique content:read. Les clés créées avant la mise en place des scopes ont des scopes null, ce qui donne un accès complet (mode hérité).

Path Parameters

  • id string requis

    Identifiant d’article Ferndesk (art_...). Exemple: art_01JXY9AZK4KV

  • revisionId string requis

    ID de révision. Exemple: rev_01JXY9AZK4KV

Response

application/json
  • articleId string

    Article restauré.

  • language string

    Langue de la révision restaurée.

  • restoredFromVersion integer

    Numéro de version de la révision restaurée.

  • newVersion integer | null

    Nouvelle version de tête créée par la restauration pour la langue principale, ou null pour une restauration de traduction.