> ## 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.

# Check a recipe, and optionally the files it goes with

> Runs the same checks as creating a release, without creating one. Send the paths of the release's files to check the recipe against them too.



## OpenAPI

````yaml /api-reference/openapi.json post /recipes/validate
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:
  /recipes/validate:
    post:
      tags:
        - Releases
      summary: Check a recipe, and optionally the files it goes with
      description: >-
        Runs the same checks as creating a release, without creating one. Send
        the paths of the release's files to check the recipe against them too.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                recipe:
                  type: object
                  additionalProperties: {}
                files:
                  type: array
                  items:
                    type: string
                  maxItems: 10000
                  description: >-
                    The release's file paths, e.g. index.html or
                    plugins/Demo.dll
      responses:
        '200':
          description: Whether it's valid, with its defaults or what to fix
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeCheck'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Not signed in
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    RecipeCheck:
      type: object
      properties:
        ok:
          type: boolean
        recipe:
          type:
            - object
            - 'null'
          additionalProperties: {}
          description: The recipe with its defaults filled in, when it's valid
        kind:
          type:
            - string
            - 'null'
          enum:
            - web_game
            - mod
            - crossover_mod
            - remix
            - null
        trust_tier:
          type:
            - string
            - 'null'
          enum:
            - sandboxed
            - game_files_only
            - runs_code
            - null
          description: Known once the files are sent (always, for a browser game)
        issues:
          type: array
          items:
            $ref: '#/components/schemas/Issue'
      required:
        - ok
        - recipe
        - kind
        - trust_tier
        - issues
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: version_exists
            message:
              type: string
            details: {}
          required:
            - code
            - message
      required:
        - error
    Issue:
      type: object
      properties:
        path:
          type: string
          description: Where in the recipe, e.g. "mappings.0.to"
        message:
          type: string
      required:
        - path
        - message

````

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