Atualizado em 17 de outubro de 2026

Considerações

  • Exige o escopo blog-categories:write e 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_title e meta_description.
  • Criar é idempotente: envie uma Idempotency-Key única (8 a 100 caracteres).
  • O DELETE desativa 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 API

Como 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.