Changelog

CRUD completo sui record di changelog del progetto.

GET/v1/changelog

Parameter	Type	Description
`locale`	`string`	Restituisci le voci in questa locale quando esiste una traduzione.
`limit`	`integer`	Dimensione pagina. Default 20.
`offset`	`integer`	Numero di elementi da saltare. Default 0.

L’elenco restituisce solo le voci pubblicate — lo stesso set che vede un visitatore del portale.

GET/v1/changelog/:id

Parameter	Type	Description
`locale`	`string`	Restituisci la voce in questa locale quando esiste una traduzione.

POST/v1/changelog

Parameter	Type	Description
`title`required	`string`	Titolo della voce.
`body`	`string`	Corpo della voce (Markdown).
`labels`	`string[]`	Etichette come New, Improved, Fixed.
`version`	`string`	Versione Semver. Default 1.0.0.
`status`	`string`	draft, scheduled, o published. Default draft.
`locale`	`string`	Locale del contenuto. Default en.

PATCH/v1/changelog/:id

Parameter	Type	Description
`title`	`string`	Titolo della voce.
`body`	`string`	Corpo della voce (Markdown).
`labels`	`string[]`	Etichette come New, Improved, Fixed.
`version`	`string`	Versione Semver. Default 1.0.0.
`status`	`string`	draft, scheduled, o published. Default draft.
`locale`	`string`	Locale del contenuto. Default en.

DELETE/v1/changelog/:id

Gli scritture richiedono accesso API del piano a pagamento Pro. DELETE restituisce 204 con un corpo vuoto.

Elenca le voci del changelog


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


{
  "data": [
    {
      "id": "ch_abc123",
      "title": "Versione 1.4.0",
      "body": "### Nuove funzionalità\n\n- Aggiunto supporto per la modalità scura\n- Nuove opzioni di esportazione\n\n### Correzioni\n\n- Risolto il problema del pulsante di esportazione su 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 }
}

Ottieni una voce del changelog


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


{
  "data": {
    "id": "ch_abc123",
    "title": "Versione 1.4.0",
    "body": "### Nuove funzionalità\n\n- Aggiunto supporto per la modalità scura\n- Nuove opzioni di esportazione\n\n### Correzioni\n\n- Risolto il problema del pulsante di esportazione su Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Crea una voce del changelog


curl -X POST https://api.supdesk.app/v1/changelog \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Versione 1.4.0",
    "body": "### Nuove funzionalità\n\n- Aggiunto supporto per la modalità scura\n- Nuove opzioni di esportazione\n\n### Correzioni\n\n- Risolto il problema del pulsante di esportazione su Safari",
    "labels": ["new", "fixed"],
    "version": "1.4.0",
    "status": "published",
    "locale": "en"
  }'


{
  "data": {
    "id": "ch_abc123",
    "title": "Versione 1.4.0",
    "body": "### Nuove funzionalità\n\n- Aggiunto supporto per la modalità scura\n- Nuove opzioni di esportazione\n\n### Correzioni\n\n- Risolto il problema del pulsante di esportazione su Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Aggiorna una voce del changelog


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


{
  "data": {
    "id": "ch_abc123",
    "title": "Versione 1.4.0 - Migliorata",
    "body": "### Nuove funzionalità\n\n- Aggiunto supporto per la modalità scura\n- Nuove opzioni di esportazione\n\n### Correzioni\n\n- Risolto il problema del pulsante di esportazione su Safari",
    "labels": ["new", "fixed"],
    "published_at": null,
    "locale": "en",
    "version": "1.4.0"
  }
}

Elimina una voce del changelog


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

Restituisce 204 No Content in caso di successo.