> ## Documentation Index
> Fetch the complete documentation index at: https://docs.patch.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# The categories, with how many public projects are in each

> In their order, whether or not anything's in them yet. `for` (comma-separated repo kinds) picks whose categories: games' and mods' by default, which are Discover's, or a toolbox shelf's (`system`, `effect`, `asset`, `character`, `tool`). `kind` (comma-separated) counts only projects of those kinds; left out, games' and mods' categories count every kind but `block`, and a shelf's count every kind.



## OpenAPI

````yaml /api-reference/openapi.json get /categories
openapi: 3.1.0
info:
  title: Patch API
  version: 1.0.0
  description: >-
    The public API behind patch.gg, the desktop app and pch. Changes within v1
    are additive only. Errors are { error: { code, message, details } }; branch
    on code.
servers:
  - url: https://patch.gg/api/v1
security: []
paths:
  /categories:
    get:
      tags:
        - Projects
      summary: The categories, with how many public projects are in each
      description: >-
        In their order, whether or not anything's in them yet. `for`
        (comma-separated repo kinds) picks whose categories: games' and mods' by
        default, which are Discover's, or a toolbox shelf's (`system`, `effect`,
        `asset`, `character`, `tool`). `kind` (comma-separated) counts only
        projects of those kinds; left out, games' and mods' categories count
        every kind but `block`, and a shelf's count every kind.
      parameters:
        - schema:
            type: string
            example: mod,crossover_mod
          required: false
          name: kind
          in: query
        - schema:
            type: string
            maxLength: 200
            example: system
          required: false
          name: for
          in: query
      responses:
        '200':
          description: The categories
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          enum:
                            - action
                            - adventure
                            - racing
                            - rpg
                            - sandbox
                            - shooter
                            - simulation
                            - strategy
                            - survival
                            - models
                            - characters
                            - surfaces
                            - 2d
                            - audio
                            - fire-smoke
                            - water
                            - sky-weather
                            - magic
                            - combat-hits
                            - nature-life
                            - screen-looks
                            - physics-destruction
                            - terrain-plants
                            - characters-animals
                            - combat-abilities
                            - building-painting
                            - vehicles
                            - blender
                            - mcp-servers
                            - importers
                            - cli-plugins
                            - skills
                        name:
                          type: string
                        for:
                          type: array
                          items:
                            type: string
                            enum:
                              - game
                              - mod
                              - system
                              - effect
                              - character
                              - asset
                              - tool
                            description: >-
                              What it is: a game, a mod, or a block for the
                              toolbox's shelves (system, effect, character,
                              asset, tool). A README can state it in its front
                              matter (`mechanic` is still read as `system`);
                              otherwise Patch reads it from the latest release,
                              the opening words of the README, and whether the
                              repo is only data files. Null when it can't tell.
                          description: The repo kinds it's for
                        projects:
                          type: integer
                      required:
                        - id
                        - name
                        - for
                        - projects
                required:
                  - data

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.