action discourse_list_categories {
  label: "Retrieves a list of categories"
  provider: discourse
  method: GET
  path: "/categories.json"
  encoding: json
  input: {
    type: "object"
    properties: {
      include_subcategories: {
        type: "boolean"
        enum: [true]
      }
    }
    additionalProperties: false
  }
  output: {
    required: ["category_list"]
    properties: {
      category_list: {
        type: "object"
        required: ["can_create_category", "can_create_topic", "categories"]
        properties: {
          can_create_category: {
            type: "boolean"
          }
          can_create_topic: {
            type: "boolean"
          }
          categories: {
            type: "array"
            items: {
              type: "object"
              required: ["id", "name", "color", "text_color", "slug", "topic_count", "post_count", "position", "description", "description_text", "description_excerpt", "topic_url", "read_restricted", "permission", "notification_level", "can_edit", "topic_template", "has_children", "sort_order", "sort_ascending", "show_subcategory_list", "num_featured_topics", "default_view", "subcategory_list_style", "default_top_period", "default_list_filter", "minimum_required_tags", "navigate_to_first_post_after_read", "topics_day", "topics_week", "topics_month", "topics_year", "topics_all_time", "subcategory_ids", "uploaded_logo", "uploaded_logo_dark", "uploaded_background"]
              properties: {
                can_edit: {
                  type: "boolean"
                }
                color: {
                  type: "string"
                }
                default_list_filter: {
                  type: "string"
                }
                default_top_period: {
                  type: "string"
                }
                default_view: {
                  type: ["string", "null"]
                }
                description: {
                  type: ["string", "null"]
                }
                description_excerpt: {
                  type: ["string", "null"]
                }
                description_text: {
                  type: ["string", "null"]
                }
                has_children: {
                  type: "boolean"
                }
                id: {
                  type: "integer"
                }
                is_uncategorized: {
                  type: "boolean"
                }
                minimum_required_tags: {
                  type: "integer"
                }
                name: {
                  type: "string"
                }
                navigate_to_first_post_after_read: {
                  type: "boolean"
                }
                notification_level: {
                  type: "integer"
                }
                num_featured_topics: {
                  type: "integer"
                }
                permission: {
                  type: "integer"
                }
                position: {
                  type: "integer"
                }
                post_count: {
                  type: "integer"
                }
                read_restricted: {
                  type: "boolean"
                }
                show_subcategory_list: {
                  type: "boolean"
                }
                slug: {
                  type: "string"
                }
                sort_ascending: {
                  type: ["string", "null"]
                }
                sort_order: {
                  type: ["string", "null"]
                }
                subcategory_ids: {
                  type: "array"
                  items: {
                    type: "object"
                  }
                }
                subcategory_list: {
                  type: ["array", "null"]
                  items: {
                    type: "object"
                  }
                }
                subcategory_list_style: {
                  type: "string"
                }
                text_color: {
                  type: "string"
                }
                topic_count: {
                  type: "integer"
                }
                topic_template: {
                  type: ["string", "null"]
                }
                topic_url: {
                  type: ["string", "null"]
                }
                topics_all_time: {
                  type: "integer"
                }
                topics_day: {
                  type: "integer"
                }
                topics_month: {
                  type: "integer"
                }
                topics_week: {
                  type: "integer"
                }
                topics_year: {
                  type: "integer"
                }
                uploaded_background: {
                  type: ["string", "null"]
                }
                uploaded_logo: {
                  type: ["string", "null"]
                }
                uploaded_logo_dark: {
                  type: ["string", "null"]
                }
              }
              additionalProperties: false
            }
          }
        }
        additionalProperties: false
      }
    }
    additionalProperties: false
  }
}