Build
Presets
Save models, instructions and tools once. Call them by name.
How presets work
- SavePick models, instructions and tools in Dashboard → Presets.
- CallSend
@preset/slugas the model. - OverrideLeave a saved setting blank to use the request, model or account default.Request fields replace saved ones.
{
"model": "@preset/product-writer",
"messages": [
{
"role": "user",
"content": "Describe our new export feature."
}
],
"max_tokens": 256
}Reference a presetWorks on Chat Completions, Responses and Messages. Bare slugs in preset are ignored; conflicting references are rejected.
- "model":
"@preset/ slug" - The preset's models.
- "preset":
"@preset/ slug" - Your
model, the preset's settings. - "model":
"vendor/ model@preset/ slug" - The same, in one field.
What the request overrides
- Settings
- Replace saved ones, including whole nested objects.
- Models
modelormodelsreplaces saved models and fallbacks.- Instructions
- Replace saved instructions.
- Tools
- Merge by name; request definitions win.An empty tools list keeps saved tools.
- Output schema
- Messages
output_formatreplaces the schema.output_configreplaces the whole saved output object, including effort. - Account and key limits
- Always apply.
What a preset savesServer tools, plugins, response caching and stored Responses continuations are not supported. Teams share presets across members; see /docs/teams.
- model
- models
- system_prompt
- temperature
- top_p
- top_k
- frequency_penalty
- presence_penalty
- repetition_penalty
- min_p
- top_a
- max_tokens
- seed
- stop
- verbosity
- service_tier
- reasoning
- response_format
- tools
- tool_choice
- parallel_tool_calls
- provider
- router
- presets per account
- 100
- versions per preset
- 200
- models per preset
- 3
- tools per preset
- 64
Routing
VersionsSaving, editing, deleting and activating require expectedRevision, so a stale edit is rejected.
- SaveCreates the active version.
- EditNew requests use it. Running requests keep theirs.
- Roll backAt 200 versions, existing versions still work. Duplicate to a new slug or contact support.Activate any earlier version.
Test before you use it
- PreviewCatalog eligibility only, not live availability, capacity, balance or Free quota. Auto picks its model again at dispatch.Free. Checks settings without inference.
- Paid testAfter a disconnect, check the receipt before retrying. A missing receipt does not prove the request was free.Runs the active saved version.
Use in ChatUse selected model instead replaces the preset's models. Chat's response limit overrides the preset's. Removing the preset restores the free trial.
- PinnedAdding a preset pins its version.
- PaidPreset chats use credit.
- Tool callsRun them from an API client.
APICapture needs a preset-management key and Idempotency-Key. It keeps settings and system instructions and discards user messages.
- POST/
presets/ validate - Preview a configuration. No inference.
- POST/
api/ v1/ presets/ {slug}/ chat/ completions - Capture a request as a new version. Also
/messagesand/responses. - GET/
presets?view=selection - Names, slugs and versions, without configuration.
- GETPOST/
presets - List or create.
- GETPATCHDELETE/
presets/ {slug} - Read, edit or delete.
- GETPOST/
presets/ {slug}/ versions - History, or save a version.
- POST/
presets/ {slug}/ activate - Make a version active.
- POST/
presets/ {slug}/ duplicate - Copy to a new slug.
- GET/
presets/ {slug}/ export - Export. Import with
POST /presets/import. - GET/
presets/ capabilities - Supported fields and limits.
- POST/
v1/ messages/ count_tokens - Count the expanded prompt.
Permissions
- Inference keysCall presets.
- Preset managementGrant it under API access. Key rotation keeps it; keys moved by an account merge need a new grant.Reads and edits configuration. Grant it only to trusted integrations.
Activity and reportsVersion filters need a preset ID. Restart pagination after changing filters. CSV exports cover 30 days.
- Activity,
/usage/requests,/generation-report, CSV presetId,presetVersionId/v1/reportpreset_id,preset_version_id- Generation detail
presetProvenance/v1/generationpreset_provenance
Archive, delete, merge
- ArchiveBlocks new requests until restored.
- DeletePermanent. Running requests finish.
- MergeDuplicate slugs, including deleted ones, block the merge.Presets move with the account.