---
title: "Create recipe"
method: POST
path: "/expression/recipes"
tags: ["Expression - Recipes"]
---

# Create recipe

`POST /expression/recipes`

Create a new expression recipe

## 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.
  - `kind` 'jsExpression' | 'templateExpression', required — Expression kind.
  - `instructTo` 'ai' | 'none', required — Instruction target.

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