Skip to main content
POST
Create recipe

Authorizations

Authorization
string
header
required

A workspace API key.

Headers

idempotency-key
string
required

Required stable id for this logical write; reuse it after a timeout. Upload endpoints also require the same value in body.idempotencyKey.

Required string length: 1 - 255

Body

application/json
scope
enum<string>
required

Recipe ownership scope; workspace recipes require workspace-owner authority.

Available options:
personal,
workspace
title
string
required

Short human-readable recipe name.

Required string length: 1 - 240
description
string
required

What the recipe does, its intended outcome, and important operating constraints.

Required string length: 1 - 4000
definition
object
required

Immutable versioned recipe behavior, outputs, quality checks, and autonomy policy.

Response

Success.

success
boolean
required
recipe
object
required
version
object
required
{key}
any