---
title: "Create a pipeline"
method: POST
path: "/pipelines/"
tags: ["Pipelines"]
---

# Create a pipeline

`POST /pipelines/`

Create and deploy a new turbo pipeline. The pipeline name must be unique within the project.

## Request body

- object
  - `name` string, required — Pipeline name. Only lowercase letters, numbers, and hyphens are allowed.
  - `resource_size` string
  - `description` string
  - `use_dedicated_ip` boolean
  - `definition` object, required
    - `sources` object, required
    - `transforms` object, required
    - `sinks` object, required

## Response `200`

Default Response

- object
  - `name` string, required
  - `type` string, required
  - `status` union, required
    - 'RUNNING'
    - 'PAUSED'
    - 'RESTARTING'
    - 'DEPLOYING'
    - 'STOPPED'
    - 'FAILED'
    - 'UNKNOWN'
  - `definition` object, required
    - `sources` object, required
    - `transforms` object, required
    - `sinks` object, required
    - `description` string
    - `resource_size` string
    - `use_dedicated_ip` boolean
    - `job` boolean
  - `resource_size` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `version` number
  - `project_id` string

---

[API](https://skmtc.dev/goldsky/apis/goldsky-api.md) · [All operations](https://skmtc.dev/goldsky/apis/goldsky-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goldsky/goldsky-api/revisions/e4e2be268b6b/schema)