---
title: "Start a Redpanda Connect pipeline"
method: PUT
path: "/v1/redpanda-connect/pipelines/{id}/start"
tags: ["Redpanda Connect Pipelines"]
---

# Start a Redpanda Connect pipeline

`PUT /v1/redpanda-connect/pipelines/{id}/start`

Start a stopped Redpanda Connect pipeline.

## Path parameters

- `id` string, required

## Response `200`

Started

- Pipeline — Defines the pipeline resource.
  - `config_yaml` string, required — The Redpanda Connect pipeline configuration in YAML format. See the [Redpanda Connect Configuration](https://docs.redpanda.com/redpanda-cloud/develop/connect/configuration/about) documentation for more details.
  - `description` string — Optional pipeline description.
  - `display_name` string, required — User-friendly pipeline name.
  - `id` string, required — Pipeline ID.
  - `resources` Resources
    - `cpu_shares` string, required — `cpu_shares` is a string specifying the amount of CPU to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "m" (e.g., "500m" for 500 millicores, "2" for 2 cores) CPU shares can be specified in millicores (1 core = 1000 millicores). If you don't specify a unit, the value is interpreted as the number of cores.
    - `memory_shares` string, required — `memory_shares` is a string specifying the amount of memory to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "K", "M", "G", "T", "P", "E" (e.g., "128M" for 128 megabytes) - Binary SI units: "Ki", "Mi", "Gi", "Ti", "Pi", "Ei" (e.g., "512Mi" for 512 mebibytes) If you don't specify a unit, the value is interpreted as bytes.
  - `service_account` PipelineServiceAccount
    - `client_id` string
    - `client_secret` string
  - `state` 'STATE_STARTING' | 'STATE_RUNNING' | 'STATE_STOPPING' | 'STATE_STOPPED' | 'STATE_ERROR' | 'STATE_COMPLETED' — State of the pipeline. - STATE_STARTING: The pipeline is starting. - STATE_RUNNING: The pipeline is running. - STATE_STOPPING: The pipeline is in the process of stopping. - STATE_STOPPED: The pipeline is stopped and in paused state. - STATE_ERROR: The pipeline encountered an error. See [Error Handling](https://docs.redpanda.com/redpanda-cloud/develop/connect/configuration/error_handling/) for further guidance. - STATE_COMPLETED: The pipeline has completed the job successfully.
  - `status` PipelineStatus — Pipeline status may contain an error message.
    - `error` string
  - `tags` object — Tags are key-value pairs that can be assigned to a pipeline resource. They help organize pipelines and enable filtering when listing them.
  - `url` string — URL to connect to the pipeline, for example, via http_server. May be empty if no http_server is used.

## Other responses

- `401` — Unauthenticated.
- `404` — Not Found
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.net/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/versions/2917b4dd86f7/schema)