---
title: "Create new version"
method: POST
path: "/expression/recipes/{uuid}"
tags: ["Expression - Recipes"]
---

# Create new version

`POST /expression/recipes/{uuid}`

Create a new version of a recipe

## Path parameters

- `uuid` string, uuid, required — Recipe identifier.

## Request body

- object — Request body schema.
  - `name` string, required — Recipe name.
  - `description` string, required — Recipe description.
  - `category` 'other' | 'classification' | 'cleaning' | 'marketing' | 'sales' | 'event' | 'copywriting', required — Recipe category.
  - `isPublic` boolean, required — Whether the recipe is public.
  - `placeholders` union[], required — Recipe placeholders.
    - union
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `kind` 'string' | 'number' | 'boolean', required
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `kind` 'enum', required
        - `enum` string[], required
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `kind` 'array', required
        - `items` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
  - `expression` string, required — Recipe expression.

## Response `200`

Successful response

- object

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/versions/1d5a19e01d83/schema)