Atualizado em 17 de outubro de 2026

Considerações

  • Exige o escopo posts:write e a permissão de criar em Posts.
  • São obrigatórios o title e o author_id (um cliente marcado como autor do blog, como no painel; liste em GET /blog-authors); o slug é gerado a partir do título quando ausente.
  • Envie o conteúdo em content (HTML pronto) ou em content_blocks (blocos do editor). Quando os dois vêm, content_blocks tem prioridade.
  • O post nasce sempre como rascunho (status: draft).

Referência

POST /posts na Referência da API

Como fazer

Envie um POST para /posts com o conteúdo do rascunho:

cURL
curl -X POST "$MICORE_BASE_URL/posts" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Como escolher sua primeira impressora",
    "author_id": 12,
    "content": "<p>Conteúdo do post.<\/p>",
    "category_id": 3
}'

Resposta

Em caso de sucesso, a API responde 201 com o post criado:

Resposta · 201
{
  "data": {
    "id": 88,
    "title": "Como escolher sua primeira impressora",
    "slug": "como-escolher-sua-primeira-impressora",
    "status": "draft",
    "content": "<p>Conteúdo do post.</p>",
    "category": { "id": 3, "name": "Guias", "slug": "guias" },
    "featured_image": null,
    "published_at": null,
    "created_at": "2026-10-17T09:00:00-03:00",
    "updated_at": "2026-10-17T09:00:00-03:00"
  }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.