---
title: "POST /beta/user/pipes"
method: POST
path: "/beta/user/pipes"
---

# POST /beta/user/pipes

`POST /beta/user/pipes`

## Request body

- object
  - `name` string, required
  - `type` 'chat' | 'generate'
  - `description` string
  - `status` 'private' | 'public'
  - `upsert` boolean
  - `config` object
    - `meta` object
      - `json` boolean
      - `store` boolean
      - `stream` boolean
      - `moderate` boolean
    - `model` object
      - `name` 'gpt-3.5-turbo' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5-2026-04-23' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.2-2025-12-11' | 'gpt-5.1-chat-latest' | 'gpt-5.1-2025-11-13' | 'gpt-5-chat-latest' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'o3' | 'o4-mini' | 'o1-pro' | 'o1' | 'o3-mini' | 'o1-preview' | 'o1-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.5-preview' | 'gpt-4o' | 'chatgpt-4o-latest' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-mini' | 'gpt-4-turbo' | 'gpt-4-turbo-preview' | 'gpt-4-0125-preview' | 'gpt-4-1106-preview' | 'gpt-4' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-1106' | 'gpt-4o-mini-2024-07-18-free' | 'Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8' | 'Qwen/Qwen3-235B-A22B-Instruct-2507-tput' | 'deepseek-ai/DeepSeek-R1-0528-tput' | 'moonshotai/Kimi-K2-Instruct' | 'Qwen/Qwen2.5-VL-72B-Instruct' | 'meta-llama/Llama-3.2-90B-Vision-Instruct-Turbo' | 'meta-llama/Llama-3.2-11B-Vision-Instruct-Turbo' | 'meta-llama/Llama-4-Scout-17B-16E-Instruct' | 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8' | 'meta-llama/Llama-3.3-70B-Instruct-Turbo' | 'deepseek-ai/DeepSeek-V3' | 'meta-llama/Meta-Llama-3.1-405B-Instruct-Turbo' | 'Qwen/Qwen2.5-72B-Instruct-Turbo' | 'meta-llama/Meta-Llama-Guard-3-8B' | 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo' | 'meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo' | 'meta-llama/Llama-3-70b-chat-hf' | 'meta-llama/Llama-3-8b-chat-hf' | 'meta-llama/Llama-2-13b-chat-hf' | 'google/gemma-2b-it' | 'mistralai/Mistral-7B-Instruct-v0.1' | 'mistralai/Mistral-7B-Instruct-v0.2' | 'mistralai/Mixtral-8x7B-Instruct-v0.1' | 'mistralai/Mixtral-8x22B-Instruct-v0.1' | 'databricks/dbrx-instruct' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-5' | 'claude-sonnet-4-6' | 'claude-opus-4-5-20251115' | 'claude-sonnet-4-5-20250929' | 'claude-opus-4-1-20250805' | 'claude-opus-4-20250514' | 'claude-sonnet-4-20250514' | 'claude-haiku-4-5-20251001' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-5-sonnet-latest' | 'claude-3-5-haiku-20241022' | 'claude-3-5-sonnet-20240620' | 'claude-3-opus-20240229' | 'claude-3-sonnet-20240229' | 'claude-3-haiku-20240307' | 'moonshotai/kimi-k2-instruct' | 'qwen/qwen3-32b' | 'meta-llama/llama-4-scout-17b-16e-instruct' | 'meta-llama/llama-4-maverick-17b-128e-instruct' | 'llama-3.3-70b-versatile' | 'deepseek-r1-distill-llama-70b' | 'llama-3.1-70b-versatile' | 'llama-3.1-8b-instant' | 'llama3-70b-8192' | 'llama3-8b-8192' | 'gemma2-9b-it' | 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite-preview-06-17' | 'gemini-2.5-pro-preview-06-05' | 'gemini-2.5-flash-preview-05-20' | 'gemini-2.5-pro-preview-05-06' | 'gemini-2.5-flash-preview-04-17' | 'gemini-2.5-pro-preview-03-25' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.0-flash-exp' | 'gemini-1.5-pro-latest' | 'gemini-1.5-flash-latest' | 'gemini-1.5-flash-8b-latest' | 'deepseek-reasoner' | 'deepseek-chat' | 'deepseek-chat-v3.1' | 'deepseek-chat-v3.1:thinking' | 'command-r' | 'command-r-plus' | 'gpt-oss-120b' | 'gpt-oss-20b' | 'llama4-scout-instruct-basic' | 'llama4-maverick-instruct-basic' | 'llama-v3p3-70b-instruct' | 'deepseek-v3' | 'qwen2p5-72b-instruct' | 'llama-v3p2-3b-instruct' | 'llama-v3p2-1b-instruct' | 'llama-v3p1-405b-instruct' | 'llama-v3p1-70b-instruct' | 'llama-v3p1-8b-instruct' | 'yi-large' | 'llama-v3-70b-instruct' | 'sonar-pro' | 'sonar' | 'pixtral-large-latest' | 'pixtral-12b' | 'magistral-medium-2506' | 'mistral-large-latest' | 'mistral-small-latest' | 'open-mistral-nemo' | 'codestral-latest' | 'grok-code-fast-1' | 'grok-4-fast-reasoning' | 'grok-4-fast-non-reasoning' | 'grok-4.1' | 'grok-4' | 'grok-3-beta' | 'grok-3-fast-beta' | 'grok-3-mini-beta' | 'grok-3-mini-fast-beta' | 'grok-beta' | 'grok-2-1212' | 'grok-2-vision-1212' | 'gpt-5-chat' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-20b' | 'qwen/qwen3-coder' | 'x-ai/grok-4' | 'mistralai/magistral-medium-2506:thinking' | 'anthropic/claude-3.7-sonnet' | 'anthropic/claude-3.7-sonnet:thinking' | 'openai/o1-pro' | 'anthropic/claude-3.5-sonnet' | 'x-ai/grok-3-beta' | 'x-ai/grok-3-mini-beta' | 'cohere/command-a' | 'perplexity/sonar-deep-research' | 'deepseek/deepseek-chat-v3-0324:free' | 'deepseek/deepseek-chat-v3-0324' | 'deepseek/deepseek-r1:free' | 'google/gemini-2.0-flash-001' | 'mistralai/mistral-small-3.1-24b-instruct' | 'mistralai/mistral-nemo' | 'google/gemma-3-27b-it:free'
      - `provider` 'OpenAI' | 'Together' | 'Anthropic' | 'Groq' | 'Google' | 'Deepseek' | 'Cohere' | 'Fireworks AI' | 'Perplexity' | 'Mistral AI' | 'xAI' | 'Azure OpenAI' | 'OpenRouter'
      - `params` object
        - `stop` string[]
        - `top_p` number
        - `max_tokens` number
        - `temperature` number
        - `presence_penalty` number
        - `frequency_penalty` number
      - `tool_choice` union
        - 'auto' | 'required'
        - object
          - `type` 'function'
          - `function` object, required
            - `name` string, required
      - `parallel_tool_calls` boolean
    - `prompt` object
      - `json` string
      - `safety` string
      - `system` string
      - `opening` string
      - `messages` object[]
        - `id` string, required
        - `role` 'user' | 'system' | 'tool' | 'assistant', required
        - `content` string, required
      - `variables` object[]
        - `name` string, required
        - `value` string, required
      - `rag` string
    - `memorysets` string[]
    - `functions` union
      - object[]
        - `type` 'function'
        - `function` object, required
          - `name` string, required
          - `description` string
          - `parameters` object
      - object[]
        - `name` string, required
        - `description` string
        - `parameters` object
    - `tools` union
      - object[]
        - `type` 'function'
        - `function` object, required
          - `name` string, required
          - `description` string
          - `parameters` object
      - object[]
        - `name` string, required
        - `description` string
        - `parameters` object

## Response `200`

Langbase: Beta create user pipe

- object
  - `name` string, required
  - `owner_login` string, required
  - `status` 'private' | 'public', required
  - `description` string
  - `type` 'chat' | 'generate'
  - `api_key` string, required
  - `url` string, required

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/langbase/apis/langbase-api.md) · [All operations](https://skmtc.net/langbase/apis/langbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langbase/langbase-api/versions/a8ae3cd9597e/schema)