Skip to main content
POST
Create a preset
This endpoint requires a management API key with presets:write and an associated user identity.
Preset configuration can contain bounded prompt, parameter, routing, and plugin defaults. Public presets use the workspace publisher handle.

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
name
string
required
Required string length: 2 - 100
Pattern: ^@[a-zA-Z0-9][a-zA-Z0-9_.-]*$
slug
string
description
string | null
Maximum string length: 500
config
object

Bounded gateway request defaults, including prompts, parameters, routing, and plugins.

visibility
enum<string>
Available options:
private,
team,
public
versioning_method
enum<string>
Available options:
sequential,
semver,
date

Response

Preset created

data
object
required
canonical_model
string
required
Last modified on August 30, 2026