action vtex_category_tree {
  label: "Get Category Tree"
  description: "Retrieves the Category Tree of your store. Get all the category levels registered in the Catalog or define the level up to which you want to get.  
\n> 📘 Onboarding guide 
\n>
\n> Check the new [Catalog onboarding guide](https://developers.vtex.com/vtex-rest-api/docs/catalog-overview). We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about Catalog and is organized by focusing on the developer's journey. 
\n## Response body example
\n
\n```json
\n[
\n    {
\n        \"id\": 1,
\n        \"name\": \"Alimentação\",
\n        \"hasChildren\": true,
\n        \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao\",
\n        \"children\": [
\n            {
\n                \"id\": 6,
\n                \"name\": \"Bebedouro\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/bebedouro\",
\n                \"children\": [],
\n                \"Title\": \"Bebedouro para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 7,
\n                \"name\": \"Comedouro\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/comedouro\",
\n                \"children\": [],
\n                \"Title\": \"Comedouro para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 8,
\n                \"name\": \"Biscoitos\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/biscoitos\",
\n                \"children\": [],
\n                \"Title\": \"Biscoitos para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 9,
\n                \"name\": \"Petiscos\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/petiscos\",
\n                \"children\": [],
\n                \"Title\": \"Petiscos para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 10,
\n                \"name\": \"Ração Seca\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/racao-seca\",
\n                \"children\": [],
\n                \"Title\": \"Ração Seca para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 11,
\n                \"name\": \"Ração Úmida\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/alimentacao/racao-umida\",
\n                \"children\": [],
\n                \"Title\": \"Ração Úmida para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            }
\n        ],
\n        \"Title\": \"Alimentação para Gatos\",
\n        \"MetaTagDescription\": \"\"
\n    },
\n    {
\n        \"id\": 2,
\n        \"name\": \"Brinquedos\",
\n        \"hasChildren\": true,
\n        \"url\": \"https://lojadobreno.vtexcommercestable.com.br/brinquedos\",
\n        \"children\": [
\n            {
\n                \"id\": 12,
\n                \"name\": \"Bolinhas\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/brinquedos/bolinhas\",
\n                \"children\": [],
\n                \"Title\": \"Bolinhas para Gatos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 13,
\n                \"name\": \"Ratinhos\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/brinquedos/ratinhos\",
\n                \"children\": [],
\n                \"Title\": \"Ratinhos\",
\n                \"MetaTagDescription\": \"\"
\n            },
\n            {
\n                \"id\": 19,
\n                \"name\": \"Arranhador para gato\",
\n                \"hasChildren\": false,
\n                \"url\": \"https://lojadobreno.vtexcommercestable.com.br/brinquedos/arranhador-para-gato\",
\n                \"children\": [],
\n                \"Title\": \"Brinquedo Arranhador para gatos\",
\n                \"MetaTagDescription\": \"Arranhador gatos é indispensável no lar com felinos. Ideais para afiar as unhas e garantir a diversão\"
\n            }
\n        ],
\n        \"Title\": \"Brinquedos para Gatos\",
\n        \"MetaTagDescription\": \"\"
\n    }
\n]
\n```"
  provider: vtex
  method: GET
  path: "/api/catalog_system/pub/category/tree/{categoryLevels}"
  encoding: json
  input: {
    type: "object"
    properties: {
      Accept: {
        type: "string"
      }
      "Content-Type": {
        type: "string"
      }
      categoryLevels: {
        type: "string"
      }
    }
    required: ["Accept", "Content-Type", "categoryLevels"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      required: ["id", "name", "hasChildren", "url", "children", "Title", "MetaTagDescription"]
      properties: {
        MetaTagDescription: {
          type: "string"
          description: "Category page Meta tag description."
        }
        Title: {
          type: "string"
          description: "Category page title."
        }
        children: {
          type: "array"
          description: "Array with information about the category's children."
          items: {
            type: "object"
            required: ["id", "name", "hasChildren", "url", "children", "Title", "MetaTagDescription"]
            properties: {
              MetaTagDescription: {
                type: "string"
                description: "Category page Meta tag description."
              }
              Title: {
                type: "string"
                description: "Category page title."
              }
              children: {
                type: "array"
                description: "Array with information about the category's children."
                items: {
                  type: "object"
                }
              }
              hasChildren: {
                type: "boolean"
                description: "If the category has a category child (`true`) or not (`false`)."
              }
              id: {
                type: "integer"
                format: "int32"
                description: "Category ID."
              }
              name: {
                type: "string"
                description: "Category name."
              }
              url: {
                type: "string"
                description: "Category URL."
              }
            }
          }
        }
        hasChildren: {
          type: "boolean"
          description: "If the category has a category child (`true`) or not (`false`)."
        }
        id: {
          type: "integer"
          format: "int32"
          description: "Category ID."
        }
        name: {
          type: "string"
          description: "Category name."
        }
        url: {
          type: "string"
          description: "Category URL."
        }
      }
    }
  }
}