Atualizado em 17 de outubro de 2026
Gerenciar categorias
Cria, edita e desativa categorias do blog pela API. É o mesmo cadastro usado pelo painel, para organizar os posts por tema.
Considerações
- Exige o escopo
blog-categories:writee a permissão correspondente em Categorias (criar, editar ou desabilitar). - Obrigatório:
name(único entre as categorias). - Opcionais:
status,parent_id(categoria pai, precisa existir),url,description,meta_titleemeta_description. - Criar é idempotente: envie uma
Idempotency-Keyúnica (8 a 100 caracteres). - O
DELETEdesativa por status (não apaga); a reativação é pelo painel.
Referência
POST /blog-categories na Referência da API PATCH /blog-categories/{blogCategory} na Referência da API DELETE /blog-categories/{blogCategory} na Referência da APIComo fazer
Crie uma categoria com um POST para /blog-categories:
cURL
curl -X POST "$MICORE_BASE_URL/blog-categories" \
-H "Authorization: Bearer $MICORE_TOKEN" \
-H "Accept: application/json" \
-H "Idempotency-Key: request-2026-0001" \
-H "Content-Type: application/json" \
-d '{
"name": "Guias",
"url": "guias",
"status": true
}'
Edite com PATCH e desative com DELETE:
cURL
curl -X DELETE "$MICORE_BASE_URL/blog-categories/3" \
-H "Authorization: Bearer $MICORE_TOKEN" \
-H "Accept: application/json"
Resposta
A criação responde 201 com a categoria; a desativação responde 200 com status: false:
Resposta · 201
{
"data": {
"id": 3,
"name": "Guias",
"slug": "guias",
"parent_id": null,
"status": true
}
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.