Obtener un artículo

Devuelve un artículo. Los artículos no publicados solo son visibles para las claves que también tienen content:write.

GET /v1/articles/{id}

Token Bearer ámbito content:read

curl 'https://api.ferndesk.com/v1/articles/art_01JXY9AZK4KV?format=markdown' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "art_01JXY9AZK4KV",
  "title": "Getting started with API keys",
  "slug": "getting-started-api-keys",
  "contentHtml": "<p>Welcome to the Ferndesk API.</p>",
  "contentMarkdown": "# Welcome to the Ferndesk API",
  "contentJson": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "content": [
          {
            "type": "text",
            "text": "Welcome to Ferndesk."
          }
        ]
      }
    ]
  },
  "url": "https://docs.example.com/getting-started-api-keys-A1B2C3",
  "sectionId": "sect_01JXYA4T1JNT",
  "collectionId": "col_01JXYA6ABN52",
  "status": "published",
  "layout": "default",
  "publishedAt": "2026-01-15T18:25:43.511Z",
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z"
}

Artículo

Parámetros de ruta

· 1

id string obligatorio

Identificador del recurso solicitado.

Parámetros de consulta

· 1

format string · por defecto: html· enumeración

Qué campo del cuerpo rellenar: contentHtml, contentMarkdown o el contentJson sin pérdidas.

valores

html
markdown
json

Parámetros de ruta

Parámetros de consulta

Respuestas