Presets

Create a preset from a chat-completions 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}/chat/completions

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

ChatRequest 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 65 of the 303 revisions of this API.10511168

    • ○

      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

    • ○

      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

    • ○

      added the new optional request property /

      new-optional-request-property

    • ○

      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

    • ○

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

    • ○

      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

    • ○

      added the new AssemblyAI enum value to the request property //////

      request-property-enum-value-added

    • ○

      added the new AssemblyAI enum value to the request property //////

      request-property-enum-value-added

    • ○

      added the new AssemblyAI enum value to the request property //////

      request-property-enum-value-added

    • ○

      added the new Near AI enum value to the request property //////

      request-property-enum-value-added

    • ○

      added the new Near AI enum value to the request property //////

      request-property-enum-value-added

    • ○

      added the new Near AI enum value to the request property //////

      request-property-enum-value-added

    • ▲

      removed the enum value NCompass of the request property //////

      request-property-enum-value-removed

    • ▲

      removed the enum value NCompass of the request property //////

      request-property-enum-value-removed

    • ▲

      removed the enum value NCompass of the request property //////

      request-property-enum-value-removed