--- title: "[DEPRECATED] Update Pipeline" --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Pipelines](https://developers.cloudflare.com/api/python/resources/pipelines) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # \[DEPRECATED] Update Pipeline Deprecated: The v1 API does not support updates. This endpoint will be removed in the future. pipelines.update(strpipeline\_name, PipelineUpdateParams\*\*kwargs) -> [PipelineUpdateResponse]() PUT/accounts/{account\_id}/pipelines/{pipeline\_name} \[DEPRECATED] Update an existing pipeline. Use the new /pipelines/v1/pipelines endpoint instead. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Pipelines Write` ##### ParametersExpand Collapse account\_id: str Specifies the public ID of the account. [Link to this property](<#(resource)%20pipelines%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) pipeline\_name: str Defines the name of the pipeline. maxLength128 minLength1 [Link to this property](<#(resource)%20pipelines%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20pipeline_name%20%3E%20(schema)>)
destination: Destination
batch: DestinationBatch max\_bytes: Optional\[int] Specifies rough maximum size of files. maximum100000000 minimum1000 Link to this property max\_duration\_s: Optional\[float] Specifies duration to wait to aggregate batches files. maximum300 minimum0.25 Link to this property max\_rows: Optional\[int] Specifies rough maximum number of rows per file. maximum10000000 minimum100 Link to this property
Link to this property
compression: DestinationCompression
type: Optional\[Literal\["none", "gzip", "deflate"]] Specifies the desired compression algorithm and format. One of the following: "none" Link to this property "gzip" Link to this property "deflate" Link to this property
Link to this property
Link to this property format: Literal\["json"] Specifies the format of data to deliver. Link to this property
path: DestinationPath bucket: str Specifies the R2 Bucket to store files. Link to this property filename: Optional\[str] Specifies the name pattern to for individual data files. Link to this property filepath: Optional\[str] Specifies the name pattern for directory. Link to this property prefix: Optional\[str] Specifies the base directory within the bucket. Link to this property
Link to this property type: Literal\["r2"] Specifies the type of destination. Link to this property
credentials: Optional\[DestinationCredentials] access\_key\_id: str Specifies the R2 Bucket Access Key Id. Link to this property endpoint: str Specifies the R2 Endpoint. Link to this property secret\_access\_key: str Specifies the R2 Bucket Secret Access Key. Link to this property
Link to this property
[Link to this property](<#(resource)%20pipelines%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20destination%20%3E%20(schema)>) name: str Defines the name of the pipeline. maxLength128 minLength1 [Link to this property](<#(resource)%20pipelines%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
source: Iterable\[Source] One of the following:
class SourceCloudflarePipelinesWorkersPipelinesHTTPSource: … \[DEPRECATED] HTTP source configuration. Use the new streams API instead. format: Literal\["json"] Specifies the format of source data. Link to this property type: str Link to this property authentication: Optional\[bool] Specifies whether authentication is required to send to this pipeline via HTTP. Link to this property
cors: Optional\[SourceCloudflarePipelinesWorkersPipelinesHTTPSourceCORS] origins: Optional\[Sequence\[str]] Specifies allowed origins to allow Cross Origin HTTP Requests. Link to this property
Link to this property
Link to this property
class SourceCloudflarePipelinesWorkersPipelinesBindingSource: … \[DEPRECATED] Worker binding source configuration. Use the new streams API instead. format: Literal\["json"] Specifies the format of source data. Link to this property type: str Link to this property
Link to this property
[Link to this property](<#(resource)%20pipelines%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20source%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class PipelineUpdateResponse: … \[DEPRECATED] Describes the configuration of a pipeline. Use the new streams/sinks/pipelines API instead. id: str Specifies the pipeline identifier. Link to this property
destination: Destination
batch: DestinationBatch max\_bytes: int Specifies rough maximum size of files. maximum100000000 minimum1000 Link to this property max\_duration\_s: float Specifies duration to wait to aggregate batches files. maximum300 minimum0.25 Link to this property max\_rows: int Specifies rough maximum number of rows per file. maximum10000000 minimum100 Link to this property
Link to this property
compression: DestinationCompression
type: Literal\["none", "gzip", "deflate"] Specifies the desired compression algorithm and format. One of the following: "none" Link to this property "gzip" Link to this property "deflate" Link to this property
Link to this property
Link to this property format: Literal\["json"] Specifies the format of data to deliver. Link to this property
path: DestinationPath bucket: str Specifies the R2 Bucket to store files. Link to this property filename: Optional\[str] Specifies the name pattern to for individual data files. Link to this property filepath: Optional\[str] Specifies the name pattern for directory. Link to this property prefix: Optional\[str] Specifies the base directory within the bucket. Link to this property
Link to this property type: Literal\["r2"] Specifies the type of destination. Link to this property
Link to this property endpoint: str Indicates the endpoint URL to send traffic. Link to this property name: str Defines the name of the pipeline. maxLength128 minLength1 Link to this property
source: List\[Source] One of the following:
class SourceCloudflarePipelinesWorkersPipelinesHTTPSource: … \[DEPRECATED] HTTP source configuration. Use the new streams API instead. format: Literal\["json"] Specifies the format of source data. Link to this property type: str Link to this property authentication: Optional\[bool] Specifies whether authentication is required to send to this pipeline via HTTP. Link to this property
cors: Optional\[SourceCloudflarePipelinesWorkersPipelinesHTTPSourceCORS] origins: Optional\[List\[str]] Specifies allowed origins to allow Cross Origin HTTP Requests. Link to this property
Link to this property
Link to this property
class SourceCloudflarePipelinesWorkersPipelinesBindingSource: … \[DEPRECATED] Worker binding source configuration. Use the new streams API instead. format: Literal\["json"] Specifies the format of source data. Link to this property type: str Link to this property
Link to this property
Link to this property version: float Indicates the version number of last saved configuration. Link to this property
[Link to this property](<#(resource)%20pipelines%20%3E%20(model)%20pipeline_update_response%20%3E%20(schema)>) ### \[DEPRECATED] Update Pipeline Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) pipeline = client.pipelines.update( pipeline_name="sample_pipeline", account_id="0123105f4ecef8ad9ca31a8372d0c353", destination={ "batch": {}, "compression": {}, "format": "json", "path": { "bucket": "bucket" }, "type": "r2", }, name="sample_pipeline", source=[{ "format": "json", "type": "type", }], ) print(pipeline.id) ``` 200 example ``` { "result": { "id": "123f8a8258064ed892a347f173372359", "destination": { "batch": { "max_bytes": 1000, "max_duration_s": 0.25, "max_rows": 100 }, "compression": { "type": "gzip" }, "format": "json", "path": { "bucket": "bucket", "filename": "${slug}${extension}", "filepath": "${date}/${hour}", "prefix": "base" }, "type": "r2" }, "endpoint": "https://123f8a8258064ed892a347f173372359.pipelines.cloudflare.com", "name": "sample_pipeline", "source": [ { "format": "json", "type": "type", "authentication": true, "cors": { "origins": [ "*" ] } } ], "version": 2 }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "id": "123f8a8258064ed892a347f173372359", "destination": { "batch": { "max_bytes": 1000, "max_duration_s": 0.25, "max_rows": 100 }, "compression": { "type": "gzip" }, "format": "json", "path": { "bucket": "bucket", "filename": "${slug}${extension}", "filepath": "${date}/${hour}", "prefix": "base" }, "type": "r2" }, "endpoint": "https://123f8a8258064ed892a347f173372359.pipelines.cloudflare.com", "name": "sample_pipeline", "source": [ { "format": "json", "type": "type", "authentication": true, "cors": { "origins": [ "*" ] } } ], "version": 2 }, "success": true } ```