Changelog

CRUD complet sur les entrées de changelog de votre projet.

GET/v1/changelog

Parameter	Type	Description
`locale`	`string`	Renvoyer les entrées dans cette langue quand une traduction existe.
`limit`	`integer`	Taille de page. 20 par défaut.
`offset`	`integer`	Nombre d'éléments à sauter. 0 par défaut.

La liste renvoie uniquement les entrées publiées — le même ensemble que voit un visiteur du portail.

GET/v1/changelog/:id

Parameter	Type	Description
`locale`	`string`	Renvoyer l'entrée dans cette langue quand une traduction existe.

POST/v1/changelog

Parameter	Type	Description
`title`required	`string`	Titre de l'entrée.
`body`	`string`	Corps de l'entrée (Markdown).
`labels`	`string[]`	Labels comme Nouveau, Amélioré, Corrigé.
`version`	`string`	Version semver. 1.0.0 par défaut.
`status`	`string`	draft, scheduled ou published. draft par défaut.
`locale`	`string`	Langue du contenu. en par défaut.

PATCH/v1/changelog/:id

DELETE/v1/changelog/:id

Les écritures exigent l’accès API d’une formule payante Pro. DELETE renvoie 204 avec un corps vide.

Lister les entrées de changelog


curl "https://api.supdesk.app/v1/changelog?locale=en&limit=20" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": [
    {
      "id": "ch_abc123",
      "title": "Version 1.4.0",
      "body": "### Nouvelles fonctionnalités\n\n- Ajout du support du mode sombre\n- Nouvelles options d'exportation\n\n### Corrections\n\n- Résolution du problème du bouton d'exportation sur Safari",
      "labels": ["new", "fixed"],
      "published_at": "2026-07-01T12:00:00Z",
      "locale": "en",
      "version": "1.4.0"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "has_more": false }
}

Obtenir une entrée de changelog


curl "https://api.supdesk.app/v1/changelog/ch_abc123?locale=en" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": {
    "id": "ch_abc123",
    "title": "Version 1.4.0",
    "body": "### Nouvelles fonctionnalités\n\n- Ajout du support du mode sombre\n- Nouvelles options d'exportation\n\n### Corrections\n\n- Résolution du problème du bouton d'exportation sur Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Créer une entrée de changelog


curl -X POST https://api.supdesk.app/v1/changelog \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Version 1.4.0",
    "body": "### Nouvelles fonctionnalités\n\n- Ajout du support du mode sombre\n- Nouvelles options d'exportation\n\n### Corrections\n\n- Résolution du problème du bouton d'exportation sur Safari",
    "labels": ["new", "fixed"],
    "version": "1.4.0",
    "status": "published",
    "locale": "en"
  }'


{
  "data": {
    "id": "ch_abc123",
    "title": "Version 1.4.0",
    "body": "### Nouvelles fonctionnalités\n\n- Ajout du support du mode sombre\n- Nouvelles options d'exportation\n\n### Corrections\n\n- Résolution du problème du bouton d'exportation sur Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Mettre à jour une entrée de changelog


curl -X PATCH https://api.supdesk.app/v1/changelog/ch_abc123 \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Version 1.4.0 - Améliorée",
    "status": "draft"
  }'


{
  "data": {
    "id": "ch_abc123",
    "title": "Version 1.4.0 - Améliorée",
    "body": "### Nouvelles fonctionnalités\n\n- Ajout du support du mode sombre\n- Nouvelles options d'exportation\n\n### Corrections\n\n- Résolution du problème du bouton d'exportation sur Safari",
    "labels": ["new", "fixed"],
    "published_at": null,
    "locale": "en",
    "version": "1.4.0"
  }
}

Supprimer une entrée de changelog


curl -X DELETE https://api.supdesk.app/v1/changelog/ch_abc123 \
  -H "Authorization: Bearer sd_live_..."

Renvoie 204 No Content en cas de succès.