Read Buildkite pipelines and builds, and create, cancel or rebuild builds.
Explore 8 workflow actions for Buildkite, including account permissions and operation limits.
5 read actions3 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Cancel build
Write
Cancel a scheduled or running build.
Permissions and limits
Account permissions
A Buildkite API access token with the write_builds scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create build
Write
Start a build of a commit on a branch, with a message, environment and meta-data.
Permissions and limits
Account permissions
A Buildkite API access token with the write_builds scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get build
Read
Read one build, optionally without its jobs.
Permissions and limits
Account permissions
A Buildkite API access token with the read_builds scope
Get pipeline
Read
Read one pipeline.
Permissions and limits
Account permissions
A Buildkite API access token with the read_pipelines scope
List organization builds
Read
Read a page of builds across the organization, filtered by state, branch, commit or time.
Permissions and limits
Account permissions
A Buildkite API access token with the read_builds scope
Pagination: page. Check the result for additional pages; a single action may not return every record.
List pipeline builds
Read
Read a page of a pipeline's builds, filtered by state, branch, commit or time.
Permissions and limits
Account permissions
A Buildkite API access token with the read_builds scope
Pagination: page. Check the result for additional pages; a single action may not return every record.
List pipelines
Read
Read a page of the organization's pipelines.
Permissions and limits
Account permissions
A Buildkite API access token with the read_pipelines scope
Pagination: page. Check the result for additional pages; a single action may not return every record.
Rebuild build
Write
Start a new build from an existing one.
Permissions and limits
Account permissions
A Buildkite API access token with the write_builds scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Buildkite. A saved workflow is not a completed provider action.