Ferndesk

Artículos

Actualizar artículo

Actualiza un artículo existente del centro de ayuda. Los cambios de contenido (título, subtítulo, cuerpo) crean y publican una nueva revisión automáticamente. Los cambios solo de metadatos (slug, campos SEO, colección) se aplican directamente.

Los artículos externos gestionados por integraciones no pueden actualizarse a través de este endpoint.

PATCH /articles/{id}

Actualizar artículo

curl --request PATCH \
  --url 'https://api.ferndesk.com/v1/articles/{ID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "id": "<string>",
  "title": "<string>",
  "contentHtml": "<string>",
  "url": "<url>",
  "sectionId": "<string>",
  "collectionId": "<string>",
  "status": "<string>",
  "publishedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Artículo actualizado

Authorizations

  • Authorization string obligatorio header

    Todas las solicitudes requieren un token Bearer en el encabezado Authorization. Las claves de API tienen el prefijo fdsk_ y deben mantenerse en secreto. Puede generar y administrar claves desde la página de Configuración de desarrolladores.

Path Parameters

  • id string obligatorio

    ID de recurso para la entidad solicitada. Ejemplo: art_01JXY9AZK4KV

Request Body

application/json
  • title string

    Título del artículo actualizado.

  • subtitle string | null

    Subtítulo del artículo actualizado.

  • content any

    Contenido del artículo actualizado.

  • collectionId string | null

    Asignación de colección actualizada.

  • keywords string

    Palabras clave SEO actualizadas.

  • metaDescription string

    Metadescripción SEO actualizada.

  • ogImage string

    URL de imagen Open Graph actualizada.

  • slug string

    Slug personalizado actualizado. Si se cambia el slug existente, se habilita el modo de slug personalizado.

Response

application/json
  • id string

    ID de artículo de Ferndesk (art_...).

  • title string

    Título principal del artículo.

  • contentHtml string

    Contenido del artículo renderizado como HTML.

  • url string (uri) | null

    URL pública canónica para este artículo.

  • sectionId string | null

    ID de la sección que contiene el artículo.

  • collectionId string | null

    ID opcional de agrupación de colección para el artículo.

  • status string | null

    Estado de publicación del artículo.

  • publishedAt string | null

    Marca de tiempo de cuando se publicó el artículo.

  • createdAt string

    Marca de tiempo ISO 8601 en UTC.

  • updatedAt string

    Marca de tiempo ISO 8601 en UTC.