Changelog

CRUD completo sobre las entradas de changelog de tu proyecto.

GET/v1/changelog

Parameter	Type	Description
`locale`	`string`	Devolver las entradas en este idioma cuando exista traducción.
`limit`	`integer`	Tamaño de página. Por defecto 20.
`offset`	`integer`	Número de elementos a saltar. Por defecto 0.

El listado devuelve solo entradas publicadas — el mismo conjunto que ve un visitante del portal.

GET/v1/changelog/:id

Parameter	Type	Description
`locale`	`string`	Devolver la entrada en este idioma cuando exista traducción.

POST/v1/changelog

Parameter	Type	Description
`title`required	`string`	Título de la entrada.
`body`	`string`	Cuerpo de la entrada (Markdown).
`labels`	`string[]`	Etiquetas como Nuevo, Mejorado, Corregido.
`version`	`string`	Versión semver. Por defecto 1.0.0.
`status`	`string`	draft, scheduled o published. Por defecto draft.
`locale`	`string`	Idioma del contenido. Por defecto en.

PATCH/v1/changelog/:id

Parameter	Type	Description
`title`	`string`	Título de la entrada.
`body`	`string`	Cuerpo de la entrada (Markdown).
`labels`	`string[]`	Etiquetas como Nuevo, Mejorado, Corregido.
`version`	`string`	Versión semver. Por defecto 1.0.0.
`status`	`string`	draft, scheduled o published. Por defecto draft.
`locale`	`string`	Idioma del contenido. Por defecto en.

DELETE/v1/changelog/:id

Las escrituras requieren acceso de API de un plan de pago Pro. DELETE devuelve 204 con cuerpo vacío.

Listar entradas de changelog


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


{
  "data": [
    {
      "id": "ch_abc123",
      "title": "Versión 1.4.0",
      "body": "### Nuevas funcionalidades\n\n- Agregado soporte para modo oscuro\n- Nuevas opciones de exportación\n\n### Correcciones\n\n- Solucionado el problema del botón de exportación en 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 }
}

Obtener una entrada de changelog


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


{
  "data": {
    "id": "ch_abc123",
    "title": "Versión 1.4.0",
    "body": "### Nuevas funcionalidades\n\n- Agregado soporte para modo oscuro\n- Nuevas opciones de exportación\n\n### Correcciones\n\n- Solucionado el problema del botón de exportación en Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Crear una entrada de changelog


curl -X POST https://api.supdesk.app/v1/changelog \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Versión 1.4.0",
    "body": "### Nuevas funcionalidades\n\n- Agregado soporte para modo oscuro\n- Nuevas opciones de exportación\n\n### Correcciones\n\n- Solucionado el problema del botón de exportación en Safari",
    "labels": ["new", "fixed"],
    "version": "1.4.0",
    "status": "published",
    "locale": "en"
  }'


{
  "data": {
    "id": "ch_abc123",
    "title": "Versión 1.4.0",
    "body": "### Nuevas funcionalidades\n\n- Agregado soporte para modo oscuro\n- Nuevas opciones de exportación\n\n### Correcciones\n\n- Solucionado el problema del botón de exportación en Safari",
    "labels": ["new", "fixed"],
    "published_at": "2026-07-01T12:00:00Z",
    "locale": "en",
    "version": "1.4.0"
  }
}

Actualizar una entrada 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": "Versión 1.4.0 - Mejorada",
    "status": "draft"
  }'


{
  "data": {
    "id": "ch_abc123",
    "title": "Versión 1.4.0 - Mejorada",
    "body": "### Nuevas funcionalidades\n\n- Agregado soporte para modo oscuro\n- Nuevas opciones de exportación\n\n### Correcciones\n\n- Solucionado el problema del botón de exportación en Safari",
    "labels": ["new", "fixed"],
    "published_at": null,
    "locale": "en",
    "version": "1.4.0"
  }
}

Eliminar una entrada de changelog


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

Devuelve 204 No Content en caso de éxito.