--- title: Update transformer --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Logpush](https://developers.cloudflare.com/api/resources/logpush) [Transformers](https://developers.cloudflare.com/api/resources/logpush/subresources/transformers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update transformer PUT/accounts/{account\_id}/logpush/transformers/{transformer\_id} Updates an existing custom log transformer. When `code` is provided, the SQL query is validated and a new version is created. When `code` is omitted, only the name and description are updated. Omitting `description` clears the existing description. ##### 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) `Logs Write` ##### P ath ParametersExpand Collapse account\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) transformer\_id: number The transformer ID. minimum1 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20transformer_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse name: string Customer-provided name for identification. maxLength255 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>) code: optional string The SQL transformer query. Maximum 32 KB. The query must contain a FROM clause referencing a valid logpush dataset. maxLength32768 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20code%20%3E%20(schema)>) description: optional string Optional customer-provided description. maxLength4096 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20description%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional object {id, associated\_jobs, created\_at, 4 more }

id: optional number The transformer ID. minimum1 Link to this property

associated\_jobs: optional array of object {id, name, object\_tag, object\_type } Logpush jobs that reference this transformer.

id: optional number The logpush job ID. Link to this property name: optional string The logpush job destination name. Link to this property object\_tag: optional string The zone or account tag. Link to this property

object\_type: optional "zone"or "account" Whether the job is zone-scoped or account-scoped.

One of the following: "zone" Link to this property "account" Link to this property

Link to this property

Link to this property created\_at: optional string When the transformer was created (RFC 3339). formatdate-time Link to this property dataset: optional string The dataset this transformer operates on, derived from the SQL query’s FROM clause. Informational only. May be absent if the dataset cannot be determined from the query. Link to this property description: optional string Optional customer-provided description. maxLength4096 Link to this property name: optional string Customer-provided name for identification. maxLength255 Link to this property updated\_at: optional string When the transformer was last modified (RFC 3339). formatdate-time Link to this property

[Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Update transformer HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/logpush/transformers/$TRANSFORMER_ID \ -X PUT \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "name": "redact-pii", "code": "SELECT ClientIP, RayID FROM http_requests", "description": "Redacts PII fields from HTTP request logs." }' ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": 42, "associated_jobs": [ { "id": 123, "name": "s3-export", "object_tag": "023e105f4ecef8ad9ca31a8372d0c353", "object_type": "zone" } ], "created_at": "2026-08-01T12:00:00Z", "dataset": "http_requests", "description": "Redacts PII fields from HTTP request logs.", "name": "redact-pii", "updated_at": "2026-08-10T15:30:00Z" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": 42, "associated_jobs": [ { "id": 123, "name": "s3-export", "object_tag": "023e105f4ecef8ad9ca31a8372d0c353", "object_type": "zone" } ], "created_at": "2026-08-01T12:00:00Z", "dataset": "http_requests", "description": "Redacts PII fields from HTTP request logs.", "name": "redact-pii", "updated_at": "2026-08-10T15:30:00Z" } } ```