---
title: "Get streams linked to a pipeline."
method: GET
path: "/pipelines/{id}/streams"
tags: ["Pipeline Operations"]
---

# Get streams linked to a pipeline.

`GET /pipelines/{id}/streams`

## Request

- Base URL: `https://replace-with-account.api.decodable.co/v1alpha2`
- URL: `https://replace-with-account.api.decodable.co/v1alpha2/pipelines/{id}/streams`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://auth.decodable.co/authorize?audience=https://api.decodable.co/`
    - Token URL: `https://auth.decodable.co/oauth/token` scopes: `read:pipeline`
- TypeScript: <https://skmtc.dev/decodable/apis/decodable-control-plane/docs/pipelines/:id/streams/get.ts> (a function with typed inputs; its response is checked against the schema)

Requires permission matching: `pipeline:read:default.<name>`.

Deprecated: please prefer `/pipelines/{id}/dependencies` instead.

## Response `200`

A list of streams linked to a pipeline.

- object
  - `next_page_token` string: A token that, that when passed to a subsequent call as page_token, will return the next page of results.
  - `items` PipelineStream[], required: An array of linked streams.
    - `pipeline_id` string: The pipeline id.
    - `version` integer: The version of the pipeline.
    - `is_source` boolean: Whether this stream is a source for the pipeline. Otherwise it is a sink.
    - `stream_id` string: The id of the linked stream

## Other responses

- `403`: Access denied: requesting user lacks a required permission.
- `404`: The requested resource does not exist.
- `default`: An error has occurred.

---

[API](https://skmtc.dev/decodable/apis/decodable-control-plane.md) - [All operations](https://skmtc.dev/decodable/apis/decodable-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/decodable/apis/decodable-control-plane/revisions/9718a3019da8?raw)