Create a preset from a responses request body

Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored.

post/presets/{slug}/responses

Path parameters

slugstring required

URL-safe slug identifying the preset. Created if it does not exist.

Example:my-preset

URL-safe slug identifying the preset. Created if it does not exist.

Request body

ResponsesRequest required— unresolved $ref

Response

Preset created or updated successfully.

Example response

{
  "data": {
    "created_at": "2026-04-20T10:00:00Z",
    "creator_user_id": "user_2dHFtVWx2n56w6HkM0000000000",
    "description": null,
    "designated_version": {
      "config": {
        "model": "openai/gpt-4o",
        "temperature": 0.7
      },
      "created_at": "2026-04-20T10:00:00Z",
      "creator_id": "user_2dHFtVWx2n56w6HkM0000000000",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "preset_id": "650e8400-e29b-41d4-a716-446655440001",
      "system_prompt": "You are a helpful assistant.",
      "updated_at": "2026-04-20T10:00:00Z",
      "version": 1
    },
    "designated_version_id": "550e8400-e29b-41d4-a716-446655440000",
    "id": "650e8400-e29b-41d4-a716-446655440001",
    "name": "my-preset",
    "slug": "my-preset",
    "status": "active",
    "status_updated_at": null,
    "updated_at": "2026-04-20T10:00:00Z",
    "workspace_id": "750e8400-e29b-41d4-a716-446655440002"
  }
}

Changes

Changed in 84 of the 303 revisions of this API.28038282

Sep 25, 202631b1cd25caca4See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new Respan enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new Respan enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new Respan enum value to the request property //////
  request-property-enum-value-added
Sep 24, 20264c8b9dc76c454See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new ScaleDown enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new ScaleDown enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new ScaleDown enum value to the request property //////
  request-property-enum-value-added
Sep 24, 20262ebaa86f752c1See the full diff
- ○
  added the new optional request property /
  new-optional-request-property
Sep 23, 2026f216e51b62a111210See the full diff
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  added the new required request property ///////
  new-required-request-property
- ▲
  removed from the // request property anyOf list
  request-property-any-of-removed
- ▲
  the ////// request property type changed from no type to object
  request-property-type-changed
- ▲
  the ////// request property type changed from no type to object
  request-property-type-changed
- ●
  removed subschema #2 from the ////// request property allOf list
  request-property-all-of-removed
- ●
  removed subschema #2 from the ////// request property allOf list
  request-property-all-of-removed
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
Sep 22, 20265f1b1cceea2c2See the full diff
- ○
  added switchyard-router discriminator mapping keys to the / request property
  request-property-discriminator-mapping-added
- ○
  added to the / request property oneOf list
  request-property-one-of-added
Sep 21, 2026f72e2b0bf8c611See the full diff
- ○
  added the new optional request property /////////////
  new-optional-request-property
- ○
  added the new optional request property /////////////
  new-optional-request-property
- ○
  added the new optional request property /////////////
  new-optional-request-property
- ○
  added the new optional request property /////////////
  new-optional-request-property
- ○
  added the new optional request property //////////////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
Sep 17, 20263066544509b53See the full diff
- ○
  added the new Unbiased enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new Unbiased enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new Unbiased enum value to the request property //////
  request-property-enum-value-added
Sep 17, 20262de027b6dfcd3See the full diff
- ○
  added the new TypeSafe enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new TypeSafe enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new TypeSafe enum value to the request property //////
  request-property-enum-value-added
Sep 17, 20268f36c27fb5168See the full diff
- ○
  added the new optional request property //////////////
  new-optional-request-property
- ○
  added the new optional request property //////////////////
  new-optional-request-property
- ○
  added the new optional request property ////////////////
  new-optional-request-property
- ○
  added the new optional request property ///////////////
  new-optional-request-property
- ○
  added the new optional request property //////////////////
  new-optional-request-property
- ○
  added the new optional request property ////////////////
  new-optional-request-property
- ○
  added the new optional request property //////////////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
Sep 16, 2026425c01b12aeb5See the full diff
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new failed enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new failed enum value to the request property ///////
  request-property-enum-value-added

Full history (84 revisions)