Como criar artigos na Central de Ajuda via API

Quando usar

Você quer criar um novo artigo na Central de Ajuda do Cloud Chat via API
Você está automatizando a publicação de conteúdo a partir de outra fonte
Você precisa de uma referência rápida do endpoint de criação

Pré-requisitos

API Key em mãos — ver Como encontrar sua API Key no Cloud Chat
ACCOUNT_ID e PORTAL_SLUG (slug do portal, ex: cloud-chat)
author_id e category_id cadastrados

Endpoint

POST /api/v1/accounts/{id}/portals/{slug}/articles

Headers

Header	Valor
`content-type`	`application/json`
`api_access_token`	Seu token de API

Campos obrigatórios

Campo	Descrição
`title`	Título do artigo
`content`	Conteúdo em Markdown
`status`	`0` (rascunho) ou `1` (publicado) — recomendamos criar como `0` e publicar com PUT depois
`author_id`	ID do autor
`category_id`	ID da categoria

Exemplo

curl --location 'https://cloudchat.cloudhumans.com/api/v1/accounts/{ACCOUNT_ID}/portals/{PORTAL_SLUG}/articles' \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: SEU_TOKEN' \
  --data '{
    "title": "Título do artigo",
    "content": "Conteúdo em Markdown...",
    "status": 0,
    "author_id": 1,
    "category_id": 1
  }'

Após criar como rascunho (status=0), publique fazendo um PUT com status=1 no mesmo article_id. Veja o fluxo completo em Como criar, atualizar ou deletar artigos na Central de Ajuda via API.

Observações

Para o fluxo completo (criar + publicar + atualizar + deletar): Como criar, atualizar ou deletar artigos na Central de Ajuda via API
Visão geral de todas as APIs disponíveis: Guia Mestre — Como acessar e operar dados do Cloud Chat via API