cloudflare · Cloudflare Workers Docs
Workers Builds API reference
Provides a workflow for programmatically managing Cloudflare Workers builds, including creating API tokens with specific permissions, identifying Worker tags, and using REST API calls to trigger builds and monitor sta...
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Builds API reference
Provides a workflow for programmatically managing Cloudflare Workers builds, including creating API tokens with specific permissions, identifying Worker tags, and using REST API calls to trigger builds and monitor sta...
When To Use
Use when you need to automate the triggering of Workers builds, manage build triggers, or programmatically monitor build status via the REST API.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-ci-cd-builds-api-reference-workflow-guide.md | A technical reference guide detailing REST API endpoints for triggering builds, managing triggers, and monitoring build status within Cloudflare Workers. | Questions about a technical reference guide detailing REST API endpoints for triggering builds, managing triggers, and monitoring bui... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-curl-re.text | A curl command demonstrating how to list Workers scripts using the Cloudflare API with Bearer token authentication. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to list Workers scripts using the Cloudflare API with Bearer token authentication. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-referen.text | A JSON representation of the Workers Builds API reference structure including worker names and tags. | Exact payloads, commands, or snippets shown in A JSON representation of the Workers Builds API reference structure including worker names and tags. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-trigger.text | A curl command used to trigger a new build for a specific Cloudflare Worker via the Builds API. | Exact payloads, commands, or snippets shown in A curl command used to trigger a new build for a specific Cloudflare Worker via the Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-trigger-2.text | A JSON object representing a configuration for a Workers Builds API trigger, including branch inclusion and exclusion rules. | Exact payloads, commands, or snippets shown in A JSON object representing a configuration for a Workers Builds API trigger, including branch inclusion and exclusion... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pos.text | A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a POST request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a POST request. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-list-bu.text | A curl command used to list builds for a specific worker via the Cloudflare Workers Builds API. | Exact payloads, commands, or snippets shown in A curl command used to list builds for a specific worker via the Cloudflare Workers Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-logs-curl-r.text | A curl command used to retrieve build logs from the Cloudflare Workers Builds API using an account ID and build UUID. | Exact payloads, commands, or snippets shown in A curl command used to retrieve build logs from the Cloudflare Workers Builds API using an account ID and build UUID. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-cancel-.text | A curl command demonstrating how to cancel a specific build using the Cloudflare Workers Builds API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to cancel a specific build using the Cloudflare Workers Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pat.text | A curl command demonstrating how to patch a Workers build trigger with custom build and deploy commands. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch a Workers build trigger with custom build and deploy commands. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-env.text | A curl command to retrieve environment variables for a specific Workers Builds trigger via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command to retrieve environment variables for a specific Workers Builds trigger via the Cloudflare API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-env-2.text | A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger using the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger using the Cloud... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-env-3.text | A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger via the Cloudfl... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-delete-.text | A curl command demonstrating how to delete a specific environment variable from a Workers Builds trigger via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to delete a specific environment variable from a Workers Builds trigger via the Clou... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pur.text | A curl command demonstrating how to purge the build cache for a specific Workers Builds trigger via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to purge the build cache for a specific Workers Builds trigger via the Cloudflare API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-github-.text | Curl commands to retrieve GitHub user or organization IDs and repository IDs using the GitHub API. | Exact payloads, commands, or snippets shown in Curl commands to retrieve GitHub user or organization IDs and repository IDs using the GitHub API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-connect.text | A curl command demonstrating how to connect a GitHub repository to Cloudflare Workers Builds using a PUT request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to connect a GitHub repository to Cloudflare Workers Builds using a PUT request. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-list-to.text | A curl command to retrieve a list of build token UUIDs and names from the Cloudflare Workers Builds API. | Exact payloads, commands, or snippets shown in A curl command to retrieve a list of build token UUIDs and names from the Cloudflare Workers Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pos-2.text | A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a POST request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a POST request. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pos-3.text | A curl command demonstrating how to trigger a new Workers build using the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to trigger a new Workers build using the Cloudflare API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-env-4.text | A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger using the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger using the Cloud... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-env-5.text | A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch environment variables for a specific Workers Builds trigger via the Cloudfl... |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pos-4.text | A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a production trigger UUID. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to trigger a new Workers build via the Cloudflare API using a production trigger UUID. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-deploym.text | A curl command used to retrieve the latest deployment version ID from the Cloudflare Workers Builds API. | Exact payloads, commands, or snippets shown in A curl command used to retrieve the latest deployment version ID from the Cloudflare Workers Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-api-list-bu-2.text | A curl command to list builds for a specific account and version using the Cloudflare Workers Builds API. | Exact payloads, commands, or snippets shown in A curl command to list builds for a specific account and version using the Cloudflare Workers Builds API. |
examples/workers-ci-cd-builds-api-reference-cloudflare-workers-builds-trigger-pos-5.text | A curl command demonstrating how to trigger a new Workers build using the Cloudflare API by providing a branch and commit hash. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to trigger a new Workers build using the Cloudflare API by providing a branch and co... |
What This Skill Covers
- This guide shows you how to use the Workers Builds REST API to programmatically trigger builds, manage triggers, and monitor build status. The examples use c...
- Main sections:
Before you start,1\. Create an API token with the correct permissions,2\. Worker tags (documented as external\script\id),3\. What is a trigger?,Workflow overview.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.cloudflare.com/workers/ci-cd/builds/api-reference