---
title: "Create an endpoint configuration"
method: POST
path: "/v1/configurations"
tags: ["Configurations"]
---

# Create an endpoint configuration

`POST /v1/configurations`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/configurations`
- Auth: HTTP bearer

Create from a preset ID or from scratch with explicit fields.

## Request body

- union
  - object
    - `presetId` string, required
  - object
    - `toolId` string, required
    - `name` string, required
    - `category` string, required
    - `path` string, required
    - `requestFormat` string: Wire dialect of the outbound request. Independent of `responseFormat`.
    - `responseFormat` string: Wire dialect expected in the response. Independent of `requestFormat`.
    - `streamEnabled` boolean
    - `parameters` object[]
      - `key` string
      - `value` string

## Response `200`

Created configuration

- EndpointConfig
  - `id` string, required
  - `toolId` string, required
  - `name` string, required
  - `category` string, required
  - `path` string, required
  - `format` string, required
  - `streamEnabled` boolean
  - `modelId` string, nullable
  - `modelValue` string, nullable
  - `parameters` object[]
    - `key` string
    - `value` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)