GET /v1/post-types

Lista os tipos de post configurados no site dono da chave de API. Use para descobrir quais slugs de post_type são válidos antes de chamar POST /v1/posts. post e page sempre existem.

• URL: https://api.canverly.com/v1/post-types
• Método: GET
• Auth: chave de API Bearer — escopo post_types:read
• Limite de requisição: 60 req/min por chave

O site é inferido a partir da chave — não há parâmetros de query.

Exemplo

curl https://api.canverly.com/v1/post-types \
  -H "Authorization: Bearer ck_live_xxx"

Resposta

200 OK

{
  "items": [
    {
      "id": "5BXZ3FZSDR98MT85BY1S0ECEYY",
      "slug": "post",
      "name": "Post",
      "plural_name": "Posts",
      "description": "",
      "is_default": true,
      "public": true,
      "hierarchical": false,
      "has_archive": true,
      "supports": ["title", "editor", "excerpt", "thumbnail", "revisions", "author", "comments"],
      "fields": [],
      "schema": null,
      "sidebar_icon": "file-text",
      "sidebar_order": 10,
      "site_id": "01KVPWYKT6AJDGG2EJN7DW4VT5",
      "org_id": "01KTBNJYSF1N1WQGX2VEZ1G0FZ",
      "created_at": "2026-06-22T05:30:46.989Z",
      "updated_at": "2026-06-22T05:30:46.989Z"
    },
    {
      "id": "7PB34VRMAJ844AN186C9Z74Z0P",
      "slug": "page",
      "name": "Página",
      "plural_name": "Páginas",
      "is_default": true,
      "public": true,
      "hierarchical": true,
      "has_archive": false,
      "supports": ["title", "editor", "thumbnail", "revisions"],
      "fields": [],
      "schema": null
    }
  ]
}

Campo	Tipo	Observações
slug	string	Use como post_type em POST /v1/posts.
name / plural_name	string	Rótulos de exibição.
is_default	boolean	true para os nativos post/page.
hierarchical	boolean	true para tipos semelhantes a página (pai/filho).
has_archive	boolean	Se o tipo tem uma listagem pública de arquivo.
supports	string[]	Recursos do editor que o tipo habilita.
fields	array	Definições de campos personalizados (para tipos de post personalizados).
schema	object | null	JSON schema dos campos personalizados, quando definido.

Erros

Status	error.code	Quando
401	unauthorized	Chave ausente/inválida.
403	forbidden	A chave não tem post_types:read.
429	rate_limited	Acima de 60 req/min.

Veja também

• Criar um post — passe um slug daqui como post_type.
• Todos os endpoints — o resto da superfície da API.