Legacy pipelines

Last updated Oct 1, 2026 Legacy pipelines, those created before September 25, 2025 via the legacy API, are on a deprecation path.

To check if your pipelines are legacy pipelines, view them in the dashboard under Basin Pipelines > Pipelines or run the basin pipelines list command in Wrangler. Legacy pipelines are labeled "legacy" in both locations.

New pipelines offer SQL transformations, multiple output formats, and improved architecture.

Notable changes

  • New pipelines support SQL transformations for data processing.
  • New pipelines write to JSON, Parquet, and Apache Iceberg formats instead of JSON only.
  • New pipelines separate streams, pipelines, and sinks into distinct resources.
  • New pipelines support optional structured schemas with validation.
  • New pipelines offer configurable rolling policies and customizable partitioning.

Moving to new pipelines

Legacy pipelines continue to work, but new features and improvements are only available in the new pipeline architecture. To migrate:

  1. Create a new pipeline using the interactive setup:npmyarnpnpm

npx wrangler basin pipelines setup

yarn wrangler basin pipelines setup

pnpm wrangler basin pipelines setup

  1. Configure your new pipeline with the desired streams, SQL transformations, and sinks.
  2. Update your applications to send data to the new stream endpoints.
  3. Once verified, delete your legacy pipeline.

For detailed guidance, refer to the getting started guide.

Was this helpful?

YesNo

On this page

Legacy pipelines - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/basin-pipelines/reference/legacy-pipelines/#page","headline":"Legacy pipelines","description":"Migration guide for pipelines created before September 2025 to the new Basin Pipelines architecture.","url":"https://developers.cloudflare.com/basin-pipelines/reference/legacy-pipelines/","inLanguage":"en","image":"https://developers.cloudflare.com/basin-pipelines/reference/legacy-pipelines/og.png?v=dca9a67a548c1471","dateModified":"2026-10-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

title: Pipelines

Skip to content

API Reference

Copy Markdown

Open in ClaudeOpen in ChatGPTOpen in Cursor

Copy MarkdownView as Markdown