API atual/Referência completa/Páginas de conteúdo

PUTAtualizar página

Altera parcialmente uma página, guardando a versão anterior no histórico.

Atualiza só os campos enviados; o resto fica como está. Antes de gravar, a plataforma guarda uma cópia da versão anterior (as 5 últimas ficam no histórico). Mudar o slug muda a URL pública, e o endereço antigo deixa de funcionar.

PUT/api/v1/admin/pages/{id}Admin

Altera campos de uma página

Exige o privilégio manage_content.

Parâmetros de caminho

iduuidobrigatório

Identificador da página.

Corpo da requisição

titlestring

Novo título (HTML é removido).

slugstring

Novo slug. Se outra página já usa, a atualização é recusada (não há sufixo automático aqui).

bodystring

Novo conteúdo HTML, sanitizado.

statusstring

activehiddendraftdisabled

Novo status.

page_typestring

pagebloglink

Novo tipo.

seo_titlestring

Título para buscadores.

seo_descriptionstring

Descrição para buscadores.

positioninteger

Ordem em menus.

vendor_iduuid

Troca o seller dono da página (só o administrador pode).

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/pages/cc37f047-702b-45c7-9f88-3e8d42e81011" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "hidden",
  "seo_title": "Troca e devolução"
}'

Resposta

200Página atualizada

json

{
  "id": "cc37f047-702b-45c7-9f88-3e8d42e81011",
  "title": "Política de Troca",
  "slug": "politica-de-troca",
  "body": "<p>Você pode trocar em até 7 dias.</p>",
  "status": "hidden",
  "page_type": "page",
  "position": 0,
  "id_path": "",
  "created_at": "2026-10-11T21:04:48.445487Z",
  "updated_at": "2026-10-11T21:04:48.445487Z",
  "page_id": "cc37f047-702b-45c7-9f88-3e8d42e81011",
  "page": "politica-de-troca",
  "page_title": "Política de Troca",
  "description": "<p>Você pode trocar em até 7 dias.</p>",
  "seo_name": "politica-de-troca",
  "timestamp": 1791752688,
  "updated_timestamp": 1791752688
}

Campos da resposta

iduuid

Identificador da página.

titlestring

Título, em texto puro (HTML é removido).

slugstring

Trecho da URL pública (/politica-de-troca). Único na loja.

bodystring

Conteúdo em HTML, já sanitizado: <script>, atributos on... e links javascript: são removidos.

statusstring

active, hidden ou draft. Veja o aviso sobre disabled.

page_typestring

page, blog ou link.

seo_titlestring

Título para buscadores. Ausente quando vazio.

seo_descriptionstring

Descrição para buscadores. Ausente quando vazia.

positioninteger

Ordem de exibição em menus. Menor aparece primeiro.

parent_iduuid

Página pai, quando a página faz parte de uma hierarquia. Ausente na raiz.

vendor_iduuid

Seller dono da página. Ausente quando a página é da loja inteira (marketplace).

created_atstring

Criação, RFC 3339 em UTC.

updated_atstring

Última alteração, RFC 3339 em UTC.

Erros

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	Corpo não é JSON válido.	`{"error":"invalid request body","detail":"..."}`
500	Status fora da lista, slug já usado por outra página, ou `id` que não é UUID. A validação responde 500 em vez de 400.	`{"detail":"invalid page status \"bogus\": must be one of active, disabled, draft, hidden","error":"failed to update page"}`

Veja também

PUTAtualizar página

Altera parcialmente uma página, guardando a versão anterior no histórico.

PUT/api/v1/admin/pages/{id}Admin

Altera campos de uma página

Exige o privilégio manage_content.

Parâmetros de caminho

iduuidobrigatório

Identificador da página.

Corpo da requisição

titlestring

Novo título (HTML é removido).

slugstring

Novo slug. Se outra página já usa, a atualização é recusada (não há sufixo automático aqui).

bodystring

Novo conteúdo HTML, sanitizado.

statusstring

activehiddendraftdisabled

Novo status.

page_typestring

pagebloglink

Novo tipo.

seo_titlestring

Título para buscadores.

seo_descriptionstring

Descrição para buscadores.

positioninteger

Ordem em menus.

vendor_iduuid

Troca o seller dono da página (só o administrador pode).

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/pages/cc37f047-702b-45c7-9f88-3e8d42e81011" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "hidden",
  "seo_title": "Troca e devolução"
}'

Resposta

200Página atualizada

json

{
  "id": "cc37f047-702b-45c7-9f88-3e8d42e81011",
  "title": "Política de Troca",
  "slug": "politica-de-troca",
  "body": "<p>Você pode trocar em até 7 dias.</p>",
  "status": "hidden",
  "page_type": "page",
  "position": 0,
  "id_path": "",
  "created_at": "2026-10-11T21:04:48.445487Z",
  "updated_at": "2026-10-11T21:04:48.445487Z",
  "page_id": "cc37f047-702b-45c7-9f88-3e8d42e81011",
  "page": "politica-de-troca",
  "page_title": "Política de Troca",
  "description": "<p>Você pode trocar em até 7 dias.</p>",
  "seo_name": "politica-de-troca",
  "timestamp": 1791752688,
  "updated_timestamp": 1791752688
}

Campos da resposta

iduuid

Identificador da página.

titlestring

Título, em texto puro (HTML é removido).

slugstring

Trecho da URL pública (/politica-de-troca). Único na loja.

bodystring

Conteúdo em HTML, já sanitizado: <script>, atributos on... e links javascript: são removidos.

statusstring

active, hidden ou draft. Veja o aviso sobre disabled.

page_typestring

page, blog ou link.

seo_titlestring

Título para buscadores. Ausente quando vazio.

seo_descriptionstring

Descrição para buscadores. Ausente quando vazia.

positioninteger

Ordem de exibição em menus. Menor aparece primeiro.

parent_iduuid

Página pai, quando a página faz parte de uma hierarquia. Ausente na raiz.

vendor_iduuid

Seller dono da página. Ausente quando a página é da loja inteira (marketplace).

created_atstring

Criação, RFC 3339 em UTC.

updated_atstring

Última alteração, RFC 3339 em UTC.

Erros

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	Corpo não é JSON válido.	`{"error":"invalid request body","detail":"..."}`
500	Status fora da lista, slug já usado por outra página, ou `id` que não é UUID. A validação responde 500 em vez de 400.	`{"detail":"invalid page status \"bogus\": must be one of active, disabled, draft, hidden","error":"failed to update page"}`