--- title: Update a build trigger --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workers Builds](https://developers.cloudflare.com/api/resources/workers_builds) [Triggers](https://developers.cloudflare.com/api/resources/workers_builds/subresources/triggers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update a build trigger PATCH/accounts/{account\_id}/builds/triggers/{trigger\_uuid} Update commands, cache settings, or branch and path filters for a trigger. ##### 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) `Workers CI Write` ##### P ath ParametersExpand Collapse account\_id: string Account identifier. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) trigger\_uuid: string Trigger UUID. formatuuid [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20trigger_uuid%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse branch\_excludes: optional array of string Branch patterns that must not start builds. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20branch_excludes%20%3E%20(schema)>) branch\_includes: optional array of string Branch patterns that can start builds. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20branch_includes%20%3E%20(schema)>) build\_caching\_enabled: optional boolean Whether builds reuse cached dependencies and build artifacts. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20build_caching_enabled%20%3E%20(schema)>) build\_command: optional string Command to build the Worker. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20build_command%20%3E%20(schema)>) build\_token\_uuid: optional string UUID of the build token used when deploying the Worker. formatuuid [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20build_token_uuid%20%3E%20(schema)>) deploy\_command: optional string Command to deploy the Worker. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20deploy_command%20%3E%20(schema)>) path\_excludes: optional array of string Path patterns that must not start builds. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20path_excludes%20%3E%20(schema)>) path\_includes: optional array of string Path patterns that can start builds. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20path_includes%20%3E%20(schema)>) root\_directory: optional string Repository directory in which build and deploy commands run. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20root_directory%20%3E%20(schema)>) trigger\_name: optional string Human-readable name of the build trigger. [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20trigger_name%20%3E%20(schema)>) ##### ReturnsExpand Collapse
errors: array of object {message, code } message: string Link to this property code: optional number Link to this property
[Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>) messages: array of string [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {branch\_excludes, branch\_includes, build\_caching\_enabled, 14 more } branch\_excludes: optional array of string Branch patterns that must not start builds. Link to this property branch\_includes: optional array of string Branch patterns that can start builds. Link to this property build\_caching\_enabled: optional boolean Whether builds reuse cached dependencies and build artifacts. Link to this property build\_command: optional string Command to build the Worker. Link to this property build\_token\_name: optional string Link to this property build\_token\_uuid: optional string UUID of the build token used when deploying the Worker. formatuuid Link to this property created\_on: optional string formatdate-time Link to this property deleted\_on: optional string formatdate-time Link to this property deploy\_command: optional string Command to deploy the Worker. Link to this property external\_script\_id: optional string System-generated tag of the Worker. This is not the Worker name. Link to this property modified\_on: optional string formatdate-time Link to this property path\_excludes: optional array of string Path patterns that must not start builds. Link to this property path\_includes: optional array of string Path patterns that can start builds. Link to this property
repo\_connection: optional object {created\_on, deleted\_on, modified\_on, 6 more } created\_on: optional string formatdate-time Link to this property deleted\_on: optional string formatdate-time Link to this property modified\_on: optional string formatdate-time Link to this property provider\_account\_id: optional string Provider-specific identifier of the account or namespace that owns the repository. Link to this property provider\_account\_name: optional string Human-readable name of the account or namespace that owns the repository. Link to this property
provider\_type: optional "github"or "gitlab"or "gitlab\_internal"or "origin" Source control provider. One of the following: "github" Link to this property "gitlab" Link to this property "gitlab\_internal" Link to this property "origin" Link to this property
Link to this property repo\_connection\_uuid: optional string Repository connection UUID. formatuuid Link to this property repo\_id: optional string Provider-specific repository identifier. Link to this property repo\_name: optional string Human-readable repository name. Link to this property
Link to this property root\_directory: optional string Repository directory in which build and deploy commands run. Link to this property trigger\_name: optional string Human-readable name of the build trigger. Link to this property trigger\_uuid: optional string Trigger UUID. formatuuid Link to this property
[Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result\_info: optional object {count, page, per\_page, 2 more } count: optional number Link to this property page: optional number Link to this property per\_page: optional number Link to this property total\_count: optional number Link to this property total\_pages: optional number Link to this property
[Link to this property](<#(resource)%20workers_builds.triggers%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### Update a build trigger HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/builds/triggers/$TRIGGER_UUID \ -X PATCH \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "branch_excludes": [ "string" ], "branch_includes": [ "main" ], "build_command": "npm run build", "deploy_command": "npx wrangler deploy", "path_excludes": [ "*.md" ], "path_includes": [ "*" ], "root_directory": "/", "trigger_name": "Production Deploy" }' ``` 200 example 401 example 404 example ``` { "errors": [ { "message": "Not found", "code": 12000 } ], "messages": [ "string" ], "result": { "branch_excludes": [ "string" ], "branch_includes": [ "main" ], "build_caching_enabled": false, "build_command": "npm run build", "build_token_name": "My Build Token", "build_token_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "created_on": "2019-12-27T18:11:19.117Z", "deleted_on": "2019-12-27T18:11:19.117Z", "deploy_command": "npx wrangler deploy", "external_script_id": "dd7160bb9cef458093557736f4b9e75b", "modified_on": "2019-12-27T18:11:19.117Z", "path_excludes": [ "*.md" ], "path_includes": [ "*" ], "repo_connection": { "created_on": "2019-12-27T18:11:19.117Z", "deleted_on": "2019-12-27T18:11:19.117Z", "modified_on": "2019-12-27T18:11:19.117Z", "provider_account_id": "cloudflare", "provider_account_name": "Cloudflare", "provider_type": "github", "repo_connection_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "repo_id": "workers-sdk", "repo_name": "workers-sdk" }, "root_directory": "/", "trigger_name": "Production Deploy", "trigger_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" }, "success": true, "result_info": { "count": 25, "page": 1, "per_page": 50, "total_count": 150, "total_pages": 3 } } ``` ``` { "errors": [ { "code": 12005, "message": "Missing token from authorization header" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 12000, "message": "Not found" } ], "messages": [], "result": null, "success": false } ``` ##### Returns Examples 200 example 401 example 404 example ``` { "errors": [ { "message": "Not found", "code": 12000 } ], "messages": [ "string" ], "result": { "branch_excludes": [ "string" ], "branch_includes": [ "main" ], "build_caching_enabled": false, "build_command": "npm run build", "build_token_name": "My Build Token", "build_token_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "created_on": "2019-12-27T18:11:19.117Z", "deleted_on": "2019-12-27T18:11:19.117Z", "deploy_command": "npx wrangler deploy", "external_script_id": "dd7160bb9cef458093557736f4b9e75b", "modified_on": "2019-12-27T18:11:19.117Z", "path_excludes": [ "*.md" ], "path_includes": [ "*" ], "repo_connection": { "created_on": "2019-12-27T18:11:19.117Z", "deleted_on": "2019-12-27T18:11:19.117Z", "modified_on": "2019-12-27T18:11:19.117Z", "provider_account_id": "cloudflare", "provider_account_name": "Cloudflare", "provider_type": "github", "repo_connection_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "repo_id": "workers-sdk", "repo_name": "workers-sdk" }, "root_directory": "/", "trigger_name": "Production Deploy", "trigger_uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" }, "success": true, "result_info": { "count": 25, "page": 1, "per_page": 50, "total_count": 150, "total_pages": 3 } } ``` ``` { "errors": [ { "code": 12005, "message": "Missing token from authorization header" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 12000, "message": "Not found" } ], "messages": [], "result": null, "success": false } ```