CI/CD
Buildkite
API integration
Ship CI/CD features without building the integration. Full Buildkite API access via Proxy, normalized data through Unified APIs, and 240+ MCP-ready tools for AI agents — all extensible to your exact use case.
Talk to usUse Cases
Why integrate with Buildkite
Common scenarios for SaaS companies building Buildkite integrations for their customers.
Sync Buildkite teams and users into your internal developer portal
IDP platforms need to map engineering org structures to service ownership. By pulling Buildkite organizations, teams, and users through Truto's Unified User Directory API, your product can automatically reflect CI/CD ownership alongside service catalogs without manual configuration.
Populate engineering analytics dashboards with org-level identity data
Productivity and DORA metrics platforms need to attribute build outcomes to specific teams and individuals. Syncing Buildkite user and group data gives your product the identity layer required to break down deployment frequency and failure rates by team.
Enforce role-based access compliance across CI/CD infrastructure
Security and compliance SaaS products need visibility into who has access to what across a customer's toolchain. Pulling Buildkite roles, users, and organizations lets your product audit CI/CD access alongside other systems in a single normalized view.
Automate team provisioning and deprovisioning in Buildkite
Identity governance platforms can use Buildkite's user and group data to detect drift between an organization's identity provider and its CI/CD permissions, flagging orphaned accounts or misconfigured team memberships.
What You Can Build
Ship these features with Truto + Buildkite
Concrete product features your team can ship faster by leveraging Truto’s Buildkite integration instead of building from scratch.
Unified org chart with CI/CD team mapping
Automatically sync Buildkite organizations, teams, and users into your product's org model so customers see their CI/CD team structure alongside data from HRIS, SCM, and other connected tools.
Cross-platform access audit report
Generate a consolidated report showing each user's roles across Buildkite and other connected platforms, highlighting over-permissioned accounts or users who should have been offboarded.
Team-level CI/CD ownership dashboard
Display which Buildkite groups own which pipelines by correlating user directory data with your product's service catalog, giving engineering leaders a clear ownership map.
Real-time user directory sync for compliance workflows
Continuously pull Buildkite user and role data to power automated compliance checks, ensuring that only authorized personnel retain access to production CI/CD pipelines.
Identity-aware incident triage view
Enrich incident management workflows by resolving Buildkite user identities so that on-call tools can automatically route CI/CD failures to the right team owner.
SuperAI
Buildkite AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
list_all_buildkite_organizations
List Buildkite organizations accessible by the user's access token. Returns a paginated collection of organization records including id, slug, name, url, web_url, pipelines_url, agents_url, emojis_url, graphql_id, and created_at.
get_single_buildkite_organization_by_id
Get a single Buildkite organization by id. Returns the organization object including id, slug, name, url, web_url, pipelines_url, agents_url, emojis_url, graphql_id, and created_at. Required: id.
list_all_buildkite_teams
List all teams in a Buildkite organization. Returns: id, graphql_id, name, slug, description, privacy, created_at, created_by. Required: org_slug.
get_single_buildkite_team_by_id
Get a single Buildkite team by id. Returns: id, graphql_id, name, slug, description, privacy, created_at, created_by. Required: org_slug, id.
create_a_buildkite_team
Create a new team in a Buildkite organization. Returns: id, name, slug, privacy, created_at, and 3 more. Required: org_slug, name, description, privacy, is_default_team, default_member_role, members_can_create_pipelines, members_can_create_suites, members_can_create_registries, members_can_destroy_registries, members_can_destroy_packages.
update_a_buildkite_team_by_id
Update an existing Buildkite team by id. Returns: id, name, slug, privacy, created_at, created_by, and 2 more. Required: org_slug, id, name, description, privacy, is_default_team, default_member_role, members_can_create_pipelines, members_can_create_suites, members_can_create_registries, members_can_destroy_registries, members_can_destroy_packages.
delete_a_buildkite_team_by_id
Delete a Buildkite team by id. Returns an empty 204 response on success. Required: org_slug, id.
buildkite_teams_enable
Enable team-based permissions for a Buildkite organization. If the organization has no existing teams, a default "Everyone" team containing all members is created. This endpoint is idempotent — if teams are already enabled it returns 204 No Content without further changes. Returns an empty 204 response on success. Required: org_slug.
list_all_buildkite_registries
List Buildkite package registries for an organization. Returns: id, created_at. Required: org_slug.
get_single_buildkite_registry_by_id
Get a single Buildkite package registry by id. Returns: id, created_at. Required: id, org_slug.
update_a_buildkite_registry_by_id
Update a Buildkite package registry by id. Returns: id, created_at. Required: id, org_slug.
delete_a_buildkite_registry_by_id
Delete a Buildkite package registry by id. Returns an empty 204 response on success. Required: id, org_slug.
create_a_buildkite_registry
Create a new Buildkite package registry in an organization. Returns: id, created_at. Required: org_slug.
list_all_buildkite_pipelines
List Buildkite pipelines for an organization, ordered newest to oldest by creation date. Returns: id, graphql_id, url, web_url, name, description, slug, repository, cluster_id, pipeline_template_uuid, provider, created_at, env, scheduled_builds_count, running_builds_count, visibility, tags, configuration, steps, and 14 more. Required: org_slug.
get_single_buildkite_pipeline_by_id
Get a single Buildkite pipeline by id. Returns: id, graphql_id, url, web_url, name, description, slug, repository, cluster_id, pipeline_template_uuid, branch_configuration, provider, created_at, archived_at, env, scheduled_builds_count, running_builds_count, visibility, tags, configuration, steps, and 12 more. Required: id, org_slug.
create_a_buildkite_pipeline
Create a new Buildkite pipeline in the specified organization using a YAML `configuration` string or a `steps` array. Returns: id, graphql_id, url, web_url, name, slug, repository, provider, created_at, env, scheduled_builds_count, running_builds_count, visibility, tags, configuration, steps, and 17 more. Required: org_slug, name, repository.
update_a_buildkite_pipeline_by_id
Update an existing Buildkite pipeline by id (partial update). Returns: id, graphql_id, url, web_url, name, description, slug, repository, cluster_id, pipeline_template_uuid, provider, created_at, archived_at, env, scheduled_builds_count, running_builds_count, visibility, tags, configuration, steps, and 13 more. Required: id, org_slug.
delete_a_buildkite_pipeline_by_id
Delete a Buildkite pipeline by id. Returns an empty 204 response on success. Required: id, org_slug.
buildkite_pipelines_add_webhook
Create a GitHub webhook for an existing Buildkite pipeline to enable GitHub-triggered builds. Returns the webhook processing state including url, enabled, disabled_at, and disabled_by. Required: org_slug, slug.
buildkite_pipelines_archive
Archive a Buildkite pipeline, making it read-only and hidden from Pipeline pages by default. Builds, logs, and artifacts are preserved. Returns the updated pipeline object including id, name, slug, archived_at, visibility, scheduled_builds_count, and running_builds_count. Required: org_slug, slug.
buildkite_pipelines_unarchive
Unarchive a Buildkite pipeline, restoring it to editable status and making it visible on Pipeline pages again. Returns the updated pipeline object including id, name, slug, archived_at (cleared to null), visibility, and build counts. Required: org_slug, slug.
list_all_buildkite_packages
List packages within a Buildkite package registry. Returns: id, created_at. Required: org_slug, registry_slug.
get_single_buildkite_package_by_id
Get a single Buildkite package by id from a package registry. Returns: id, created_at. Required: id, org_slug, registry_slug.
delete_a_buildkite_package_by_id
Delete a Buildkite package by id from a package registry. Returns an empty 204 response on success. Required: id, org_slug, registry_slug.
create_a_buildkite_package
Upload and publish a package to a Buildkite package registry via multipart file upload. Returns: id, created_at. Required: org_slug, registry_slug, file.
buildkite_packages_copy
Copy a package to another Buildkite package registry. Returns: id, created_at. Required: org_slug, registry_slug, package_id.
list_all_buildkite_artifacts
List all Buildkite artifacts for a build across all of its jobs. Returns: id, job_id, url, download_url, state, path, dirname, filename, mime_type, file_size, glob_path, original_path, sha1sum. Required: org_slug, pipeline_slug, build_number. Accepts a build number (e.g. 3), not a build ID.
get_single_buildkite_artifact_by_id
Get a single Buildkite artifact by id. Returns: id, job_id, url, download_url, state, path, dirname, filename, mime_type, file_size, glob_path, original_path, sha1sum. Required: id, org_slug, pipeline_slug, build_number, job_id. Accepts a build number (e.g. 3), not a build ID.
delete_a_buildkite_artifact_by_id
Delete a Buildkite artifact by id, marking it as deleted in the database and removing it from the Buildkite S3 bucket. Returns an empty 204 response on success. Required: id, org_slug, pipeline_slug, build_number, job_id.
buildkite_artifacts_download
Get a presigned download URL for a Buildkite artifact. Returns: url, id, job_id, download_url, state, path, dirname, filename, mime_type, file_size, sha1sum. Required: org_slug, pipeline_slug, number, job_id, artifact_id.
buildkite_artifacts_list_for_job
List all Buildkite artifacts for a specific job within a build. Returns: id, job_id, url, download_url, state, path, dirname, filename, mime_type, file_size, glob_path, original_path, sha1sum. Required: org_slug, pipeline_slug, number, job_id. Accepts a build number (e.g. 3), not a build ID.
buildkite_artifacts_list_by_job_id
List all artifacts for a specific Buildkite job. Returns: id, job_id, url, download_url, state, path, dirname, filename, mime_type, file_size, glob_path, original_path, sha1sum. Required: org_slug, job_id. Optionally filter by state or path (glob patterns supported).
buildkite_artifacts_get_by_job_id
Get a single Buildkite artifact by its id within a job. Returns: id, job_id, url, download_url, state, path, dirname, filename, mime_type, file_size, glob_path, original_path, sha1sum. Required: org_slug, job_id, artifact_id.
buildkite_artifacts_download_by_job_id
Get a temporary download URL for a Buildkite artifact within a job. Returns a 302 redirect with the pre-signed artifact URL in the response body, valid for 60 seconds (or a standard public S3 URL when using a custom S3 bucket). Returns: url, id, job_id, download_url, state, path, dirname, and 4 more. Required: org_slug, job_id, artifact_id.
buildkite_artifacts_delete_by_job_id
Delete a Buildkite artifact by its id within a job. Marks the artifact as deleted in the Buildkite database and removes it from Buildkite-managed AWS S3 storage. Returns an empty 204 response on success. Required: org_slug, job_id, artifact_id.
list_all_buildkite_clusters
List all clusters in a Buildkite organization. Returns a paginated array of cluster objects, each including id, name, description, emoji, color, maintainers, url, web_url, queues_url, default_queue_url, created_at, and created_by. Required: org_slug.
get_single_buildkite_cluster_by_id
Get a single Buildkite cluster by id. Returns the cluster object including id, name, description, emoji, color, maintainers, default_queue_id, url, web_url, queues_url, created_at, created_by, hosted_git_mirror_enabled, hosted_container_cache_enabled, agent_tracing_service_uuid, and default_cache_registry_uuid. Required: id, org_slug.
create_a_buildkite_cluster
Create a new cluster in a Buildkite organization. Returns the created cluster object including id, graphql_id, name, description, emoji, color, maintainers, url, web_url, queues_url, default_queue_url, created_at, and created_by. Required: org_slug, name.
update_a_buildkite_cluster_by_id
Update an existing Buildkite cluster by id. Returns the updated cluster object including id, name, description, emoji, color, maintainers, default_queue_id, url, web_url, queues_url, default_queue_url, created_at, and created_by. Required: id, org_slug.
delete_a_buildkite_cluster_by_id
Delete a Buildkite cluster by id. Returns an empty 204 response on success. Required: id, org_slug.
buildkite_clusters_partial_update
Update a Buildkite cluster by id. Returns the updated cluster object including id, name, description, emoji, color, maintainers, url, web_url, queues_url, default_queue_id, created_at, created_by, hosted_git_mirror_enabled, hosted_container_cache_enabled, agent_tracing_service_uuid, and 2 more fields. Required: org_slug, cluster_id.
list_all_buildkite_annotations
List Buildkite annotations for a specific build. Returns: id, context, style, scope, job_id, priority, body_html, created_at, updated_at. Required: org_slug, pipeline_slug, build_number. Note: build_number is the numeric build number, not the build ID.
create_a_buildkite_annotation
Create an annotation on a Buildkite build. Returns the created annotation including id, context, style, scope, job_id, priority, body_html, created_at, and updated_at. Required: org_slug, pipeline_slug, build_number, body. Note: build_number is the numeric build number, not the build ID.
delete_a_buildkite_annotation_by_id
Delete an annotation from a Buildkite build by its UUID. Returns an empty 204 response on success. Required: org_slug, pipeline_slug, build_number, id.
buildkite_annotations_list_for_job
List Buildkite annotations for a specific job. Returns: id, context, style, scope, job_id, priority, body_html, created_at, updated_at. Required: org_slug, job_id.
buildkite_annotations_create_for_job
Create an annotation scoped to a specific Buildkite job, automatically setting scope to 'job'. Returns the created annotation including id, context, style, scope, job_id, priority, body_html, created_at, and updated_at. Required: org_slug, job_id, body.
buildkite_annotations_delete_for_job
Delete an annotation on a Buildkite job by annotation UUID. Returns an empty 204 response on success. Required: org_slug, job_id, annotation_uuid.
buildkite_annotations_list_for_build_job
List annotations for a Buildkite job using the build-scoped route. Returns a paginated list of annotation objects including id, context, style, scope, job_id, priority, body_html, created_at, and updated_at. Required: org_slug, pipeline_slug, build_number, job_id.
buildkite_annotations_create_for_build_job
Create a job-scoped annotation on a Buildkite build job. The scope is automatically set to job. Returns the created annotation including id, context, style, scope, job_id, priority, body_html, created_at, and updated_at. Required: org_slug, pipeline_slug, build_number, job_id, body.
buildkite_annotations_delete_for_build_job
Delete an annotation on a Buildkite job using the build-scoped route. Returns an empty 204 response on success. Required: org_slug, pipeline_slug, build_number, job_id, annotation_uuid.
list_all_buildkite_me
Get basic details about the Buildkite user account associated with the API token in use. Returns: id, graphql_id, name, email, avatar_url, created_at.
list_all_buildkite_builds
List all Buildkite builds across all authorized organizations and pipelines, ordered newest first. Returns build objects including id, number, state, branch, commit, source, jobs, created_at, and pipeline. Supports filtering by branch, commit, creator, date ranges, and build state.
get_single_buildkite_build_by_id
Get a single Buildkite build by its build number within a specific pipeline. Returns the build object including id, number, state, branch, commit, message, jobs, job_state_counts, creator, created_at, and pipeline. Required: org_slug, pipeline_slug, id (build number).
create_a_buildkite_build
Create a new Buildkite build for a pipeline. Returns the new build object including id, number, state, branch, commit, message, jobs, creator, created_at, and pipeline. Required: org_slug, pipeline_slug, commit, branch.
buildkite_builds_cancel
Cancel a running or scheduled Buildkite build by its build number. Returns the updated build object including id, state, cancel_reason, branch, commit, message, jobs, created_at, and pipeline. Required: org_slug, pipeline_slug, number.
buildkite_builds_list_for_organization
List all Buildkite builds for a specific organization across all its pipelines, ordered newest first. Returns build objects including id, number, state, branch, commit, source, jobs, created_at, and pipeline. Required: org_slug.
buildkite_builds_list_for_pipeline
List builds for a specific Buildkite pipeline, ordered newest first. Returns: id, graphql_id, url, web_url, number, state, message, commit, branch, source, creator, jobs, created_at, scheduled_at, started_at, failing_at, finished_at, meta_data, pull_request, merge_queue, rebuilt_from, pipeline, and 9 more. Required: org_slug, pipeline_slug.
buildkite_builds_rebuild
Rebuild a Buildkite build by creating a new build from the same commit and branch. Returns the new build object including id, number, state, branch, commit, source, jobs, created_at, scheduled_at, and pipeline. Required: org_slug, pipeline_slug, number.
buildkite_builds_retry_failed_jobs
Retry all failed jobs in a Buildkite build. Returns the updated build object with id, number, state, branch, commit, source, jobs, created_at, scheduled_at, and pipeline. Required: org_slug, pipeline_slug, number.
list_all_buildkite_team_members
List all members associated with a Buildkite team. Returns: role, created_at, user_id, user_name. Required: org_slug, team_uuid.
create_a_buildkite_team_member
Create an association between a Buildkite team and a user. Returns: role, created_at, user_id, user_name. Required: org_slug, team_uuid, user_id, role.
delete_a_buildkite_team_member_by_id
Remove the association between a Buildkite team and a user. Returns an empty 204 response on success. Required: id, org_slug, team_uuid.
get_single_buildkite_team_member_by_id
Get a single Buildkite team member by id. Returns: role, created_at, user_id, user_name. Required: id, org_slug, team_uuid.
update_a_buildkite_team_member_by_id
Update the role of a Buildkite team member. Returns: role, created_at, user_id, user_name. Required: id, org_slug, team_uuid, role.
list_all_buildkite_org_members
List all members of a Buildkite organization. Returns: id, name, email, role, sso_mode. Required: org_slug.
get_single_buildkite_org_member_by_id
Get a single Buildkite organization member by id. Returns: id, name, email, role, sso_mode. Required: org_slug, id.
update_a_buildkite_org_member_by_id
Update a Buildkite organization member's role or SSO mode by id. Returns: id, name, email, role, sso_mode. Required: org_slug, id.
delete_a_buildkite_org_member_by_id
Remove a member from a Buildkite organization by id. Returns an empty 204 response on success. Required: org_slug, id.
get_single_buildkite_audit_event_by_id
Get a single Buildkite audit event by id. Returns the full event object including uuid, type, occurred_at, actor, subject, context, data, and url. Required: org_slug, id.
list_all_buildkite_audit_events
List Buildkite audit events for an organization, ordered from newest to oldest. Returns per event: uuid, type, occurred_at, actor, subject, context, data, and url. Required: org_slug.
list_all_buildkite_build_tests
List Buildkite Test Engine tests for a specific build, with execution metrics aggregated over the build's time window. Returns: id, url, web_url, scope, name, location, file_name, state, state_changed_at, labels, reliability, duration_avg, duration_sum, duration_min, duration_max, executions_count, and 2 more. Required: org, build_id.
get_single_buildkite_execution_trace_by_id
Get the OpenTelemetry trace recorded for a Buildkite test execution, showing where execution time went rolled up by category and ranked by self-time. Returns: execution_id, trace_id, trace_status, span_count, and 16 more. An execution with no recorded trace returns an empty trace rather than a 404. Required: id, org, suite_slug, execution_id.
list_all_buildkite_executions_slowests
List the slowest individual test executions for a Buildkite build across every suite that received execution data from it, returned slowest first. Returns an array of BuildExecution records whose field set is defined by the Buildkite Test Engine REST API spec. Required: org, build_id. This is a top-N list, not a paginated collection; use limit to…
get_single_buildkite_organization_api_setting_by_id
Get the API security settings for a Buildkite organization by id. Returns: url, allowed_ip_addresses, revoke_inactive_tokens_after_days, restrict_user_api_token_creation, features. Required: organization_id.
buildkite_organization_api_settings_bulk_update
Update one or more API security settings for a Buildkite organization. Include only the fields you want to change. Returns: url, allowed_ip_addresses, revoke_inactive_tokens_after_days, restrict_user_api_token_creation, features. Required: org_slug.
get_single_buildkite_organization_pipeline_setting_by_id
Get pipeline settings for a Buildkite organization. Returns: url, default_branch, default_cluster_id, default_timeout_in_minutes, maximum_timeout_in_minutes, scheduled_job_expiry_in_minutes, hosted_agents_terminal_access, public_pipeline_creation, advanced_queue_metrics, build_exports. Required: organization_id.
buildkite_organization_pipeline_settings_bulk_update
Update Buildkite organization pipeline settings via partial PATCH; only fields included in the request body are changed. Returns: url, default_branch, default_cluster_id, default_timeout_in_minutes, maximum_timeout_in_minutes, scheduled_job_expiry_in_minutes, hosted_agents_terminal_access, public_pipeline_creation, and 2 more. Required: org_slug.
organization_pipeline_settings_enable_hosted_agents_ssh
Enable SSH and VNC remote access for hosted agents in a Buildkite organization. Returns: url, default_branch, default_cluster_id, default_timeout_in_minutes, maximum_timeout_in_minutes, scheduled_job_expiry_in_minutes, hosted_agents_terminal_access, public_pipeline_creation, advanced_queue_metrics, build_exports. Required: org_slug.
organization_pipeline_settings_disable_hosted_agents_ssh
Disable SSH and VNC remote access for hosted agents in a Buildkite organization. Returns the updated pipeline settings including: url, hosted_agents_terminal_access, default_branch, default_cluster_id, build_exports, and other settings fields. Required: org_slug.
buildkite_organization_pipeline_settings_enable_public_pipelines
Allow organization members to create public pipelines in Buildkite. Returns the updated pipeline settings including: url, public_pipeline_creation, default_branch, default_cluster_id, hosted_agents_terminal_access, advanced_queue_metrics, and build_exports. Required: org_slug.
organization_pipeline_settings_disable_public_pipelines
Disable public pipeline creation for a Buildkite organization, preventing members from creating public pipelines. Returns the updated pipeline settings including url, public_pipeline_creation, advanced_queue_metrics, build_exports, default_branch, and default_cluster_id. Required: org_slug.
organization_pipeline_settings_enable_advanced_queue_metrics
Enable advanced queue metrics for clusters in a Buildkite organization. This is a one-way operation — once enabled it cannot be disabled via the API (disable_supported will be false). Returns the updated pipeline settings including url, advanced_queue_metrics, public_pipeline_creation, and build_exports. Required: org_slug.
buildkite_organization_pipeline_settings_configure_build_export
Configure the build data export destination and strategy for a Buildkite organization. Returns the updated pipeline settings including url, build_exports (with available, enabled, location, strategy_id, supported_strategies), default_branch, and advanced_queue_metrics. Required: org_slug, location, strategy_id.
buildkite_organization_pipeline_settings_disable_build_export
Disable build data export for a Buildkite organization, clearing the export configuration and stopping further data exports. Returns the updated pipeline settings including url, build_exports (with enabled: false, location: null, strategy_id: null), default_branch, and advanced_queue_metrics. Required: org_slug.
get_single_buildkite_organization_rate_limit_by_id
Get the current REST, GraphQL, and per-user rate limit status for a Buildkite organization. Returns a scopes object with rest, rest_user, mcp, and graphql sub-objects, each containing limit, current, reset, reset_at, and enforced. Note: requests to this endpoint do not count towards any rate limit. Required: id.
list_all_buildkite_organization_suites
List all Test Engine suites in a Buildkite organization, ordered by creation time. Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, oidc_policy, test_state_management, allowed_test_states, api_token, bearerAuth. Required: org.
create_a_buildkite_organization_suite
Create a new Test Engine suite in a Buildkite organization. Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, oidc_policy, test_state_management, allowed_test_states, api_token, bearerAuth. Required: org, name, default_branch.
get_single_buildkite_organization_suite_by_id
Get a single Test Engine suite by id. Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, oidc_policy, test_state_management, allowed_test_states, api_token, bearerAuth. Required: org, id.
update_a_buildkite_organization_suite_by_id
Update a Test Engine suite by id using a full PUT replacement. Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, oidc_policy, test_state_management, allowed_test_states, api_token, bearerAuth. Required: org, id.
buildkite_organization_suites_partial_update
Partially update a Test Engine suite in a Buildkite organization. Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, oidc_policy, test_state_management, allowed_test_states, api_token, pipelines_url, agents_url, emojis_url, created_at. Required: org, suite_id.
delete_a_buildkite_organization_suite_by_id
Delete a Buildkite Test Engine suite by id. Required: org, id. Returns an empty 204 response on success.
get_single_buildkite_organization_usage_by_id
Get the usage summary for a Buildkite organization by id. Returns: description, reporting_period, generated_at, scope, active_users_count, active_users_count_definition, pipelines, test_engine, packages, artifacts. Required: id. Optionally filter by a custom date range using from and to (YYYY-MM-DD, both must be supplied together).
list_all_buildkite_pipeline_suites
List Test Engine suites associated with a Buildkite pipeline, ordered by creation time — each suite is returned once (must have recorded at least one run attributed to the pipeline). Returns: id, graphql_id, organization_id, slug, name, url, web_url, default_branch, application_name, color, emoji, and 5 more. Required: org, pipeline_slug.
list_all_buildkite_run_failed_executions
List failed executions for a Buildkite Test Engine run. Returns an array of execution records including execution_id, test_name, failure_reason, branch, commit_sha, duration, location, created_at, and associated URLs. Required: org, suite_slug, run_id.
list_all_buildkite_span_aggregates_scopes
List instrumentation scope aggregates for a Buildkite Test Engine suite. Returns each scope's name, count, and total_duration across all builds in the requested period, ordered by total duration descending then name ascending. All results are returned without pagination; requires OTel trace ingestion. Data has hourly precision and is retained…
list_all_buildkite_span_aggregates_scopes_span_aggregates
List span aggregate instrumentation scopes for a Buildkite build. Returns an array of scope objects, each including its scope_name, ordered by total duration descending then name ascending. Returns all scopes without pagination; use span-aggregates/span-names to drill into a specific scope. Required: org, build_id.
list_all_buildkite_span_aggregates_span_names
Get span-name statistics for a Buildkite Test Engine suite's instrumentation scope. Returns: scope_name, span_names, span_names_truncated, bearerAuth. Returns up to 100 spans per request; defaults to 20. Required: org, suite_slug, scope_name.
list_all_buildkite_span_aggregates_span_names_span_names
List span-name statistics for a Buildkite build's instrumentation scope. Returns top-N span name aggregates for the requested scope, with span_names_truncated indicating when more names exist. Defaults to 20 results; max 100. Required: org, build_id, scope_name.
buildkite_suite_execution_tags_bulk_update
Bulk replace mutable tags on a batch of test executions in a Buildkite Test Engine suite. Every tag key must carry the mutable-tag prefix. Returns: access_level, created_at, suite_id, suite_url. Required: org, suite_slug, executions.
list_all_buildkite_suite_runs
List Buildkite Test Engine suite runs ordered newest first, optionally filtered by build UUID. Returns: id, branch, commit_sha, state, result, executions_count, executions_count_by_result, url, web_url, build_id, created_at, bearerAuth. Required: org, suite_slug.
get_single_buildkite_suite_run_by_id
Get a single Buildkite Test Engine suite run by id. Returns: id, branch, commit_sha, state, result, executions_count, executions_count_by_result, url, web_url, build_id, created_at, bearerAuth. Required: org, suite_slug, id.
list_all_buildkite_suite_tests
List tests in a Buildkite Test Engine suite with execution metrics aggregated over a selected time window. Returns: id, url, web_url, scope, name, location, file_name, state, state_changed_at, labels, reliability, duration_avg, duration_sum, duration_min, duration_max, executions_count, and 2 more. Required: org, suite_slug.
get_single_buildkite_suite_test_by_id
Get a Buildkite test by id with aggregated duration, reliability, and execution metrics over a time range. Returns: id, url, web_url, scope, name, location, file_name, state, state_changed_at, labels, reliability, duration_avg, duration_sum, duration_min, duration_max, executions_count, and 4 more. Required: org, suite_slug, id.
buildkite_suite_tests_bulk_update
Add or remove labels on a Buildkite test. Returns the updated test including id, name, scope, location, file_name, state, labels, url, web_url. Required: org, suite_slug, test_id, operator, labels.
buildkite_suite_tests_update_enable
Enable a Buildkite test within a suite, setting its state to enabled (requires state management to be enabled on the suite). Returns the updated test including id, name, scope, location, file_name, state, url, web_url. Required: org, suite_slug, test_id.
get_single_buildkite_suite_upload_by_id
Get a specific test result upload by id from a Buildkite analytics suite. Returns: id, suite_id, organization_id, run_id, run_env, tags, uploaded_at, bearerAuth. Required: org, suite_slug, id.
list_all_buildkite_suite_workflows
List Buildkite Test Engine workflows for a suite, ordered newest first. Returns: id, url, web_url, monitor, filters, alarm_actions, recover_actions, created_at, updated_at, created_by, bearerAuth. Required: org, suite_slug.
create_a_buildkite_suite_workflow
Create a workflow in a Buildkite Test Engine suite to monitor tests and act on them. Returns: id, url, web_url, monitor, filters, alarm_actions, recover_actions, created_at, updated_at, created_by, bearerAuth. Required: org, suite_slug, monitor.
get_single_buildkite_suite_workflow_by_id
Get a single Buildkite Test Engine suite workflow by id. Returns: id, url, web_url, monitor, filters, alarm_actions, recover_actions, created_at, updated_at, created_by, bearerAuth. Required: org, suite_slug, id.
update_a_buildkite_suite_workflow_by_id
Update a Buildkite Test Engine suite workflow by id. Keys omitted from the body retain their current value. Returns: id, url, web_url, monitor, filters, alarm_actions, recover_actions, created_at, updated_at, created_by, bearerAuth. Required: org, suite_slug, id.
delete_a_buildkite_suite_workflow_by_id
Delete a Buildkite Test Engine suite workflow by id. Returns an empty 204 response on success. Required: org, suite_slug, id.
buildkite_test_mutes_bulk_update
Mute a test in a Buildkite Test Engine suite, suppressing its failure reporting. Returns the updated test object including id, url, web_url, scope, name, location, file_name, and state. Required: org, suite_slug, test_id. Requires state management to be enabled for the suite.
buildkite_test_skips_bulk_update
Skip a test in a Buildkite Test Engine suite, setting its lifecycle state to skipped. Returns the updated test object including id, name, location, file_name, scope, state, url, and web_url. Required: org, suite_slug, test_id. The suite must have state management enabled.
buildkite_tests_finds_search
Find a single Buildkite Test Analytics test by its scope and name within a suite. Returns: id, url, web_url, scope, name, location, file_name, state, state_changed_at, labels, bearerAuth. Required: org, suite_slug, name, scope. Returns 404 when no matching test exists.
list_all_buildkite_tests_muteds
List muted tests within a Buildkite Test Engine suite. Returns an array of test records including id, url, web_url, scope, name, location, file_name, and state. Required: org, suite_slug. Requires the suite to have state management enabled.
list_all_buildkite_tests_skippeds
List skipped tests within a Buildkite Test Engine suite. Requires the suite to have state management enabled. Returns each test's id, name, scope, location, file_name, state, labels, reliability, duration metrics (duration_avg, duration_sum, duration_min, duration_max), executions_count, and executions_count_by_result. Required: org, suite_slug.
get_single_buildkite_agent_by_id
Get a single Buildkite agent by id. Returns any agent regardless of connection state, including id, name, connection_state, hostname, version, queue, creator, job, connected_at, and meta_data. Required: org_slug, id.
list_all_buildkite_agents
List Buildkite agents in an organization (only connected and stopping agents are returned; use get to retrieve agents in any connection state). Returns: id, graphql_id, url, web_url, name, connection_state, hostname, ip_address, user_agent, version, os_id, arch, queue, creator, created_at, job, meta_data, and 6 more. Required: org_slug.
buildkite_agents_pause
Pause a Buildkite agent to prevent new jobs from being dispatched to it while keeping the agent running until its current job completes. Returns an empty 204 response on success. Required: org_slug, agent_id.
buildkite_agents_resume
Resume a paused Buildkite agent so it can accept new build jobs again. Returns an empty 204 response on success. Required: org_slug, agent_id.
buildkite_agents_stop
Stop a Buildkite agent, instructing it to stop accepting new build jobs and shut itself down. Returns an empty 204 response on success. Required: org_slug, agent_id.
buildkite_jobs_cancel
Cancel a running Buildkite job, transitioning it to the canceling state. Returns the updated job object including id, state, command, created_at, started_at, and additional lifecycle, retry, and cluster fields. Required: org_slug, pipeline_slug, number, job_id.
buildkite_jobs_create_ssh_session
Create an SSH session for a running command job on a macOS or Linux Buildkite hosted agent. Returns connection details including endpoint, access_token, expires_at, transport, and ssh credentials (username, private_key, host_keys). Required: org_slug, job_id.
buildkite_jobs_create_vnc_session
Create a VNC remote desktop session for a running command job on a macOS Buildkite hosted agent. Returns connection details including endpoint, access_token, expires_at, and vnc credentials (username, password). Required: org_slug, job_id.
buildkite_jobs_delete_log
Delete the log output for a specific Buildkite job. Returns an empty 204 response on success. Required: org_slug, pipeline_slug, number, job_id.
buildkite_jobs_get_env
Get the environment variables set for a Buildkite job. Returns env, an object containing key-value string pairs for all variables available to the job, such as BUILDKITE_BRANCH, BUILDKITE_COMMIT, and BUILDKITE_BUILD_NUMBER. Required: org_slug, pipeline_slug, number, job_id.
buildkite_jobs_get_log
Get the log output for a specific Buildkite job. Returns: url, content, size, header_times. Required: org_slug, pipeline_slug, number, job_id.
buildkite_jobs_reprioritize
Reprioritize a Buildkite job by changing its priority value, affecting the order in which agents pick it up. Returns the updated job including id, state, priority, command, and created_at. Required: org_slug, pipeline_slug, number, job_id, priority.
buildkite_jobs_retry
Retry a failed or canceled Buildkite job, creating a new attempt for the same pipeline step. Returns the new job object including id, state, retries_count, command, and created_at. Required: org_slug, pipeline_slug, number, job_id.
buildkite_jobs_unblock
Unblock a Buildkite "Block pipeline" job to allow a paused build to continue. Returns the unblocked job including id, type, label, state, unblocked_by, and unblocked_at. Required: org_slug, pipeline_slug, number, job_id.
list_all_buildkite_jobs
List all jobs in a Buildkite build, optionally filtered by state, step key, or group key. Returns: id, graphql_id, type, name, step_key, step, state, build_url, web_url, log_url, artifacts_url, command, soft_failed, exit_status, created_at, started_at, finished_at, retried, cluster_id, and 23 more. Required: org_slug, pipeline_slug, build_number.
get_single_buildkite_job_by_id
Get a single Buildkite job by id using only the organization slug and job UUID. Returns the full job object including id, type, name, state, command, step_key, exit_status, soft_failed, created_at, started_at, and finished_at. Required: org_slug, id.
buildkite_jobs_get_for_build
Get a single Buildkite job scoped to a specific pipeline build. Returns the full job object including id, type, name, state, command, step_key, exit_status, soft_failed, created_at, started_at, and finished_at. Required: org_slug, pipeline_slug, build_number, job_id.
buildkite_jobs_get_env_by_job_id
Get the environment variables set for a Buildkite job. Returns: env, id, graphql_id, type, name, step_key, step, priority, agent_query_rules, state, build_url, web_url, log_url, raw_log_url, artifacts_url, command, soft_failed, created_at, scheduled_at, runnable_at, started_at, retried. Required: org_slug, job_id.
buildkite_jobs_get_log_by_job_id
Get the log output for a Buildkite job. Returns: url, content, size, header_times. Required: org_slug, job_id.
buildkite_jobs_delete_log_by_job_id
Delete the log output for a Buildkite job by organization slug and job ID. Returns an empty 204 response on success. Required: org_slug, job_id.
buildkite_jobs_cancel_by_job_id
Cancel a running Buildkite command job, transitioning it to canceling or canceled state. Returns the updated job object including id, state, type, command, started_at, created_at, and other job fields. Required: org_slug, job_id.
buildkite_jobs_retry_by_job_id
Retry a failed or timed-out Buildkite job, creating a new scheduled job attempt. Returns the retried job object including id, graphql_id, type, name, state, command, created_at, retries_count, and additional timing and retry metadata fields. Required: org_slug, job_id.
buildkite_jobs_unblock_by_job_id
Unblock a Buildkite 'Block pipeline' job by job_id, allowing the build to continue. Returns the unblocked job object including id, type, label, state, unblocked_by, unblocked_at, and unblock_url. Required: org_slug, job_id.
buildkite_jobs_reprioritize_by_job_id
Reprioritize a Buildkite job by job_id, changing its priority value to affect agent pickup order. Returns the updated job object including id, state, step_key, command, and priority. Required: org_slug, job_id, priority.
create_a_buildkite_notification_service
Create a Buildkite notification service for an organization. Returns the created service including id, provider, enabled, scope, build_states, settings, and created_at. Required: org_slug, provider.
delete_a_buildkite_notification_service_by_id
Delete a Buildkite notification service by id. Returns an empty 204 response on success. Required: org_slug, id.
buildkite_notification_services_disable
Disable a Buildkite notification service. Returns the updated service object including id, enabled (set to false), provider, scope, build_states, settings, and created_at. Required: org_slug, uuid.
buildkite_notification_services_enable
Enable a Buildkite notification service and clear any previous disabled or broken state. Returns the updated service object including id, enabled (set to true), provider, scope, build_states, settings, and created_at. Required: org_slug, uuid.
get_single_buildkite_notification_service_by_id
Get a single Buildkite notification service by id. Returns the service object including id, provider, enabled, scope, build_states, settings, and created_at. Required: org_slug, id.
list_all_buildkite_notification_services
List Buildkite notification services for an organization, ordered from oldest to newest. Returns each service's id, provider, description, enabled, scope, build_states, settings, and created_at. Required: org_slug.
update_a_buildkite_notification_service_by_id
Update a Buildkite notification service by id. Only fields included in the request are changed; omitted top-level fields and settings remain unchanged. Returns the updated service including id, provider, description, enabled, scope, build_states, settings, and created_at. Required: org_slug, id.
get_single_buildkite_pipeline_trigger_delivery_by_id
Get a single Buildkite pipeline trigger delivery by id. Returns: id, url, request_url, received_at, content_type, external_id, status, reason, builds. Required: id, org_slug, pipeline_slug, trigger_id.
buildkite_pipeline_trigger_deliveries_get_request
Get the original request Buildkite Pipelines received for a pipeline trigger delivery, including its parsed payload and allowlisted headers. Returns: content_type, headers, payload, id, url, request_url, received_at, status, reason, builds. Required: org_slug, pipeline_slug, trigger_id, delivery_id.
list_all_buildkite_pipeline_trigger_deliveries
List a Buildkite pipeline trigger's retained deliveries, newest first. Returns: id, url, request_url, received_at, content_type, external_id, status, reason, builds. Required: org_slug, pipeline_slug, trigger_id.
create_a_buildkite_pipeline_trigger
Create a new Buildkite pipeline trigger for a pipeline. Returns: id, url, type, label, enabled, build, filter, verification, endpoint_url, endpoint_url_hint, created_at, created_by, updated_at, updated_by, pipeline. The endpoint_url (plaintext token) is only included in this response — save it securely. Required: org_slug, pipeline_slug, type.
delete_a_buildkite_pipeline_trigger_by_id
Delete a Buildkite pipeline trigger by id, immediately stopping it from accepting incoming webhook deliveries. Returns an empty 204 response on success. Required: org_slug, pipeline_slug, id.
get_single_buildkite_pipeline_trigger_by_id
Get a single Buildkite pipeline trigger by id. Returns: id, url, type, label, enabled, build, filter, verification, endpoint_url_hint, created_at, created_by, updated_at, updated_by, pipeline. Required: org_slug, pipeline_slug, id.
list_all_buildkite_pipeline_triggers
List all pipeline triggers for a Buildkite pipeline, ordered most recently created first. Returns per trigger: id, type, label, enabled, build, filter, endpoint_url_hint, created_at, created_by, updated_at, updated_by, and pipeline. Full endpoint URLs and verification secrets are excluded from list responses. Required: org_slug, pipeline_slug.
update_a_buildkite_pipeline_trigger_by_id
Update a Buildkite pipeline trigger by id. Omitted fields remain unchanged. Returns the updated trigger object including id, type, label, enabled, build, filter, verification, endpoint_url_hint, updated_at, and updated_by. Required: org_slug, pipeline_slug, id.
get_single_buildkite_repository_connection_by_id
Get a single Buildkite repository connection by id. Returns: id, type, display_name, url, service_account, host, rate_limit. Required: org_slug, id.
list_all_buildkite_repository_connections
List all repository connections for a Buildkite organization. Returns an unpaginated array of connections, each including id, type, display_name, and url. Required: org_slug.
create_a_buildkite_team_pipeline
Create an association between a team and a pipeline in Buildkite. Returns: pipeline_id, access_level, pipeline_url, created_at. Required: org_slug, team_uuid, pipeline_id, access_level.
get_single_buildkite_team_pipeline_by_id
Get a single team-pipeline association in Buildkite by id. Returns: pipeline_id, access_level, pipeline_url, created_at. Required: org_slug, team_uuid, id.
list_all_buildkite_team_pipelines
List all pipeline associations for a Buildkite team. Returns: pipeline_id, access_level, pipeline_url, created_at. Required: org_slug, team_uuid.
delete_a_buildkite_team_pipeline_by_id
Remove the association between a team and a pipeline in Buildkite. Returns an empty 204 response on success. Required: org_slug, team_uuid, id.
update_a_buildkite_team_pipeline_by_id
Update the access level of a team-pipeline association in Buildkite. Returns: pipeline_id, access_level, pipeline_url, created_at. Required: org_slug, team_uuid, id, access_level.
list_all_buildkite_meta
Get meta information about Buildkite. Returns the webhook_ips field — a list of IP addresses in CIDR notation that Buildkite uses for outbound traffic such as webhooks and commit statuses. Does not require authentication. Buildkite recommends checking for new addresses daily.
create_a_buildkite_agent_image
Create a new agent image in a Buildkite cluster with a custom Dockerfile body. Do not include a FROM instruction — Buildkite prepends its managed base image automatically. Builds are asynchronous; poll get until status changes from BUILDING to READY or FAILED. Returns: id, name, status, and 9 more. Required: org_slug, cluster_id, name, dockerfile.
delete_a_buildkite_agent_image_by_id
Delete a Buildkite agent image by id. Fails with 409 Conflict if the image is currently assigned to one or more queues — reassign those queues to a different agent image first. Returns an empty 204 response on success. Required: id, org_slug, cluster_id.
get_single_buildkite_agent_image_by_id
Get a single Buildkite agent image by id. Returns: id, name, status, image_ref, version, last_build_error, dockerfile, base_image, composed_dockerfile, url, web_url, cluster_url. Required: id, org_slug, cluster_id.
list_all_buildkite_agent_images
List all agent images in a Buildkite cluster, sorted alphabetically by name. Non-hosted clusters return an empty list. Returns: id, name, status, image_ref, version, last_build_error, dockerfile, base_image, composed_dockerfile, url, web_url, cluster_url. Required: org_slug, cluster_id.
buildkite_cache_volumes_bulk_delete
Delete a Buildkite cluster cache volume by its tag. Pass the `tag` value from a list response in the request body (not the volume `id`). Returns an empty 204 response on success. Required: org_slug, cluster_id, tag.
list_all_buildkite_cache_volumes
List cache volumes for a Buildkite hosted agent cluster. Returns an unpaginated list of the latest detached cache volume for each tag, including id, tag, cluster_id, size_mb, created_at, attached_at, and detached_at. Volumes not yet detached are excluded. Required: org_slug, cluster_id.
create_a_buildkite_agent_token
Create an agent token for a Buildkite cluster. Returns the token record including the one-time secret token value plus id, description, allowed_ip_addresses, expires_at, url, cluster_url, created_at, and created_by; the secret value is never returned by later requests. Required: description, org_slug, cluster_id.
delete_a_buildkite_agent_token_by_id
Revoke an agent token by id so agents configured with it can no longer connect to their Buildkite cluster. Returns an empty 204 response on success. Required: id, org_slug, cluster_id.
get_single_buildkite_agent_token_by_id
Get a single agent token of a Buildkite cluster by id. Returns: id, graphql_id, description, allowed_ip_addresses, expires_at, url, cluster_url, created_at, created_by. Required: id, org_slug, cluster_id.
list_all_buildkite_agent_tokens
List a Buildkite cluster's agent tokens. Returns a paginated collection of token records with id, graphql_id, description, allowed_ip_addresses, expires_at, url, cluster_url, created_at, and created_by. Required: org_slug, cluster_id.
update_a_buildkite_agent_token_by_id
Update an agent token in a Buildkite cluster by id. Returns the updated token record with id, description, allowed_ip_addresses, expires_at, url, cluster_url, created_at, and created_by. Required: id, org_slug, cluster_id.
create_a_buildkite_pipeline_template
Create a pipeline template in a Buildkite organization. Returns the created template including uuid, name, configuration, available, and created_by. Required: org_slug, name, and configuration.
delete_a_buildkite_pipeline_template_by_id
Delete a pipeline template in a Buildkite organization by id (its UUID). A template can only be deleted when it is not assigned to any pipelines. Returns an empty 204 response on success. Required: org_slug and id.
get_single_buildkite_pipeline_template_by_id
Get a single Buildkite pipeline template by id (its UUID). Returns: uuid, graphql_id, name, description, configuration, available, url, web_url, created_at, created_by, updated_at, updated_by. Required: org_slug and id.
list_all_buildkite_pipeline_templates
List a Buildkite organization's pipeline templates. Returns each template's uuid, name, description, configuration, available, and created_by. Required: org_slug.
update_a_buildkite_pipeline_template_by_id
Update a Buildkite pipeline template by id (its UUID). Returns the updated template including uuid, name, configuration, available, and updated_at. Required: org_slug and id.
create_a_buildkite_portal
Create a Buildkite portal that exposes a stored GraphQL operation through an authenticated URL endpoint. Returns: uuid, slug, organization_uuid, name, description, query, created_at, created_by, allowed_ip_addresses, user_invokable, token. Required: org_slug, name, query.
delete_a_buildkite_portal_by_id
Delete a Buildkite portal in an organization by id (the portal's slug). Returns an empty 204 response on success. Required: org_slug, id.
get_single_buildkite_portal_by_id
Get a single Buildkite portal by id (the portal slug). Returns: uuid, slug, organization_uuid, name, description, query, created_at, created_by, allowed_ip_addresses, user_invokable. Required: org_slug, id.
list_all_buildkite_portals
List a Buildkite organization's portals. Returns portal records with uuid, slug, name, query, created_at, and created_by. Required: org_slug.
update_a_buildkite_portal_by_id
Update a Buildkite portal by id (the portal slug). Returns the updated portal with uuid, slug, name, description, query, allowed_ip_addresses, and user_invokable. All body fields are optional. Required: org_slug, id.
create_a_buildkite_queue
Create a queue in a Buildkite cluster — self-hosted, or a Buildkite hosted queue via the hostedAgents body property. Returns: id, graphql_id, key, description, url, web_url, cluster_url, retry_agent_affinity, dispatch_paused, dispatch_paused_by, and 6 more. Required: org_slug, cluster_id, key. A custom agent image URL cannot be set at creation.
delete_a_buildkite_queue_by_id
Delete a queue from a Buildkite cluster by id. Returns the deleted queue record with id, graphql_id, key, description, url, web_url, cluster_url, retry_agent_affinity, dispatch_paused, created_at, and created_by. Required: org_slug, cluster_id, id.
get_single_buildkite_queue_by_id
Get a single queue in a Buildkite cluster by id. Returns the queue object: id, graphql_id, key, description, dispatch_paused, created_at, created_by. Required: org_slug, cluster_id, id.
list_all_buildkite_queues
List a Buildkite cluster's queues as a paginated collection. Returns queue objects: id, graphql_id, key, description, dispatch_paused, created_at, created_by. Required: org_slug, cluster_id.
buildkite_queues_pause
Pause job dispatching for a queue in a Buildkite cluster so jobs stop being sent to its associated agents. Returns: id, graphql_id, key, description, url, web_url, cluster_url, dispatch_paused, dispatch_paused_by, dispatch_paused_at, dispatch_paused_note, hosted, created_at, created_by, and 2 more. Required: org_slug, cluster_id, queue_id.
buildkite_queues_resume
Resume job dispatch on a paused Buildkite cluster queue. Returns the queue including its id, key, description, dispatch_paused state, and created_at. Required: org_slug, cluster_id, queue_id. Fails if the queue is not paused.
update_a_buildkite_queue_by_id
Update a Buildkite cluster queue by id — change its description, retry agent affinity, or hosted agent shape. Returns: id, graphql_id, key, description, url, web_url, cluster_url, retry_agent_affinity, dispatch_paused, dispatch_paused_note, created_at, created_by, hosted, hosted_agents, and 2 more. Required: id, org_slug, cluster_id.
create_a_buildkite_rule
Create a rule in a Buildkite organization that allows an action between a source and target resource, such as one pipeline triggering another's builds. Returns: uuid, graphql_id, organization_uuid, url, type, source_type, source_uuid, target_type, target_uuid, effect, action, created_at, created_by. Required: org_slug, type, value.
delete_a_buildkite_rule_by_id
Delete a rule from a Buildkite organization by its UUID. Returns an empty 204 response on success. Required: org_slug, id (the rule UUID).
get_single_buildkite_rule_by_id
Get a single rule in a Buildkite organization by its UUID. Returns: uuid, graphql_id, organization_uuid, url, type, source_type, source_uuid, target_type, target_uuid, effect, action, created_at, created_by. Required: org_slug and id (the rule UUID).
list_all_buildkite_rules
List the rules configured in a Buildkite organization. Returns rule objects with uuid, type, effect, action, source_uuid, target_uuid, and created_at. Required: org_slug.
create_a_buildkite_team_suite
Associate a suite with a team in Buildkite. Returns the created team suite with suite_id, suite_url, created_at, and access_level. Required: org_slug, team_uuid, suite_id, access_level.
delete_a_buildkite_team_suite_by_id
Delete a team suite association in Buildkite by id (suite UUID). Returns an empty 204 response on success. Required: id, org_slug, team_uuid.
get_single_buildkite_team_suite_by_id
Get a single team suite association in Buildkite by id (suite UUID). Returns: suite_id, suite_url, created_at, access_level. Required: id, org_slug, team_uuid.
list_all_buildkite_team_suites
List the suites associated with a team in Buildkite. Returns: suite_id, suite_url, created_at, access_level. Required: org_slug, team_uuid.
update_a_buildkite_team_suite_by_id
Update a team suite association in Buildkite by id (suite UUID). Returns: suite_id, suite_url, created_at, access_level. Required: org_slug, team_uuid, access_level, id.
list_all_buildkite_emojis
List all emojis for a Buildkite organization, including custom emojis and aliases. Returns: name, url, aliases. This list is not paginated. Required: org_slug.
list_all_buildkite_network_ranges
List the egress network ranges (IP CIDR blocks) that Buildkite hosted agents in a cluster use for outbound traffic, for firewall allowlisting. Returns: cidr_range, kind. Unpaginated; non-hosted clusters or clusters with no configured ranges return an empty list. Required: org_slug, cluster_id.
list_all_buildkite_cluster_secrets
List all secrets in a Buildkite cluster. Returns: id, created_at. Required: org_slug, cluster_id.
get_single_buildkite_cluster_secret_by_id
Get a single Buildkite cluster secret by id. Returns: id, created_at. Required: id, org_slug, cluster_id.
create_a_buildkite_cluster_secret
Create a new secret in a Buildkite cluster. Returns: id, created_at. Required: org_slug, cluster_id.
update_a_buildkite_cluster_secret_by_id
Update a Buildkite cluster secret by id. Returns: id, created_at. Required: id, org_slug, cluster_id.
buildkite_cluster_secrets_update_value
Update the stored value of a Buildkite cluster secret. Returns: id, created_at. Required: org_slug, cluster_id, secret_id.
delete_a_buildkite_cluster_secret_by_id
Delete a cluster secret by id in Buildkite. Permanently removes the specified secret from the given cluster. Returns an empty 204 response on success. Required: org_slug, cluster_id, id.
list_all_buildkite_cluster_maintainers
List all maintainers (users and teams) for a Buildkite cluster. Returns each maintainer record including id and actor object (with id, graphql_id, name, and type-specific fields such as email and type for users or slug for teams). Required: org_slug, cluster_id.
get_single_buildkite_cluster_maintainer_by_id
Get a single cluster maintainer in Buildkite by id. Returns the maintainer record including id and actor object (with id, graphql_id, name, and type-specific fields such as email and type for users or slug for teams). Required: org_slug, cluster_id, id.
create_a_buildkite_cluster_maintainer
Add a user or team as a maintainer of a Buildkite cluster. Returns the created maintainer record including id and actor (with id, graphql_id, name, and type-specific fields). Required: org_slug, cluster_id.
delete_a_buildkite_cluster_maintainer_by_id
Remove a maintainer from a Buildkite cluster by id. Returns an empty 204 response on success. Required: org_slug, cluster_id, id.
list_all_buildkite_cache_registries
List cache registries in a Buildkite cluster. Returns: id, created_at, updated_at. Required: org_slug, cluster_id.
get_single_buildkite_cache_registry_by_id
Get a single Buildkite cache registry by id. Returns: id, created_at, updated_at. Required: id, org_slug, cluster_id.
create_a_buildkite_cache_registry
Create a cache registry in a Buildkite cluster. Returns: id, created_at, updated_at. Required: org_slug, cluster_id.
update_a_buildkite_cache_registry_by_id
Update a Buildkite cache registry by id. Returns: id, created_at, updated_at. Required: id, org_slug, cluster_id.
delete_a_buildkite_cache_registry_by_id
Delete a Buildkite cache registry by id. Returns an empty 204 response on success. Required: id, org_slug, cluster_id.
get_single_buildkite_organization_banner_by_id
Get the current organization banner for a Buildkite organization. Returns the banner object including its id and banner-specific attributes. Required: id.
update_a_buildkite_organization_banner_by_id
Set or update the organization banner for a Buildkite organization. Returns the updated banner object including its id and banner-specific attributes. Required: id.
delete_a_buildkite_organization_banner_by_id
Delete the organization banner for a Buildkite organization by id. Returns an empty 204 response on success. Required: id.
list_all_buildkite_organization_invitations
List pending organization invitations in Buildkite. Returns: id, created_at, graphql_id, url, web_url, name, slug, pipelines_url, agents_url, emojis_url. Required: org_slug.
get_single_buildkite_organization_invitation_by_id
Get a single Buildkite organization invitation by id. Returns: id, created_at, graphql_id, url, web_url, name, slug, pipelines_url, agents_url, emojis_url. Required: org_slug, id.
create_a_buildkite_organization_invitation
Create (send) an organization invitation in Buildkite. Returns: id, created_at, graphql_id, url, web_url, name, slug, pipelines_url, agents_url, emojis_url. Required: org_slug.
delete_a_buildkite_organization_invitation_by_id
Delete (revoke) a Buildkite organization invitation by id. Returns an empty 204 response on success. Required: org_slug, id.
list_all_buildkite_pipeline_schedules
List all pipeline schedules for a Buildkite pipeline. Returns: access_level, created_at, pipeline_id, pipeline_url. Required: org_slug, pipeline_slug.
get_single_buildkite_pipeline_schedule_by_id
Get a single pipeline schedule by id in Buildkite. Returns: access_level, created_at, pipeline_id, pipeline_url. Required: id, org_slug, pipeline_slug.
create_a_buildkite_pipeline_schedule
Create a pipeline schedule for a Buildkite pipeline. Returns: access_level, created_at, pipeline_id, pipeline_url. Required: org_slug, pipeline_slug, pipeline_id, access_level.
update_a_buildkite_pipeline_schedule_by_id
Update a pipeline schedule by id in Buildkite. Returns: access_level, created_at, pipeline_id, pipeline_url. Required: id, org_slug, pipeline_slug.
delete_a_buildkite_pipeline_schedule_by_id
Delete a pipeline schedule by id in Buildkite. Returns an empty 204 response on success. Required: id, org_slug, pipeline_slug.
get_single_buildkite_pipeline_github_webhook_by_id
Get the GitHub webhook processing state for a Buildkite pipeline. Returns: url, enabled, disabled_at, disabled_by. Required: org_slug, pipeline_id.
update_a_buildkite_pipeline_github_webhook_by_id
Enable GitHub webhook processing for a Buildkite pipeline. Idempotent — if processing is already enabled, returns the current state unchanged. Returns: url, enabled, disabled_at, disabled_by. Required: org_slug, id.
delete_a_buildkite_pipeline_github_webhook_by_id
Disable GitHub webhook processing for a Buildkite pipeline, recording who disabled it and when. Idempotent — if processing is already disabled, returns the current state unchanged. Returns: url, enabled, disabled_at, disabled_by. Required: org_slug, id.
list_all_buildkite_step_uploads
List step uploads for a specific Buildkite build. Returns step upload records (including their id) scoped to the given organization, pipeline, and build number. Required: org_slug, pipeline_slug, build_number.
get_single_buildkite_step_upload_by_id
Get a single step upload by id within a specific Buildkite build. Returns the step upload record including its id. Required: id, org_slug, pipeline_slug, build_number.
list_all_buildkite_registry_tokens
List registry tokens for a Buildkite package registry. Returns a paginated list of tokens including id, description, url, expires_at, created_at, and created_by. Required: org_slug, registry_slug.
get_single_buildkite_registry_token_by_id
Get a single Buildkite package registry token by id. Returns: id, graphql_id, description, allowed_ip_addresses, expires_at, url, created_at, created_by. Required: id, org_slug, registry_slug.
create_a_buildkite_registry_token
Create a new token for a Buildkite package registry. Returns: id, graphql_id, description, allowed_ip_addresses, expires_at, url, created_at, created_by. Required: org_slug, registry_slug.
update_a_buildkite_registry_token_by_id
Update an existing Buildkite package registry token by id. Returns: id, graphql_id, description, allowed_ip_addresses, expires_at, url, created_at, created_by. Required: id, org_slug, registry_slug.
delete_a_buildkite_registry_token_by_id
Delete a Buildkite package registry token by id. Returns an empty 204 response on success. Required: id, org_slug, registry_slug.
list_all_buildkite_repository_connection_repositories
List repositories accessible through a specific Buildkite repository connection. Returns: id, display_name, url. Required: org_slug, repository_connection_id.
list_all_buildkite_access_token
Get details about the Buildkite API access token used to authenticate the request. Returns: uuid, scopes, description, created_at, expires_at, user.
buildkite_access_token_revoke
Revoke the Buildkite API access token used to authenticate the request. Once revoked, the token can no longer be used for further requests. Returns an empty 204 response on success.
Why Truto
Why use Truto’s MCP server for Buildkite
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 1100+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
Unified APIs
Unified APIs for Buildkite
Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.
Unified User Directory API
Groups
Groups are a collection of users in the source application. In some applications, they might also be called Teams.
Me
Organizations
Organizations are the top level entity in the source application. Users are associated with an organization.
Roles
The Role object represents a role of a User.
Users
The User object represents a User.
How It Works
From zero to integrated
Start with Buildkite in a free sandbox, usually ready within one business day. No boilerplate, no maintenance burden.
Link your customer’s Buildkite account
Use Truto’s frontend SDK to connect your customer’s Buildkite account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call Buildkite
Truto’s Proxy API is a 1-to-1 mapping of the Buildkite API. You call us, we call Buildkite, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate Buildkite’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about Buildkite on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
What Buildkite data can I access through Truto today?
Truto's Unified User Directory API supports syncing Buildkite Groups, Users, Roles, Organizations, and the authenticated user (Me). CI/CD-specific resources like Pipelines, Builds, and Jobs are not yet available as pre-built tools but can be built on request.
How does authentication work for Buildkite integrations?
Buildkite supports API token-based authentication. Your end users generate an API access token from their Buildkite account settings with the required scopes. Truto handles storing and managing these credentials securely on your behalf.
Does Buildkite have rate limits I should be aware of?
Yes. Buildkite's REST API enforces rate limits on a per-token basis. Truto manages pagination and respects these limits automatically so your integration doesn't get throttled during large data syncs.
Can I request custom Buildkite tools beyond the Unified User Directory API?
Absolutely. Truto builds integration tools on request. If you need access to Buildkite Pipelines, Builds, Jobs, Agents, or Annotations, Truto can build and expose those resources — typically covering both the REST v2 and GraphQL APIs that Buildkite offers.
How does Truto normalize Buildkite's user and team data?
Truto maps Buildkite-specific concepts like Organizations, Teams, and Members onto its Unified User Directory schema (Organizations, Groups, Users, Roles). This means your product code works the same way regardless of whether the underlying source is Buildkite, GitHub, or an HRIS system.
Does Buildkite use a REST API or GraphQL API?
Buildkite offers both a REST API (v2) and a GraphQL API. Buildkite recommends GraphQL for complex or nested queries. Truto abstracts this complexity — you interact with a single unified API regardless of which Buildkite API is used under the hood.
From the Blog
Buildkite integration guides
Deep dives, architecture guides, and practical tutorials for building Buildkite integrations.
Buildkite
Get Buildkite integrated into your app
Our team understands what it takes to make a Buildkite integration successful. A short, crisp 30 minute call with folks who understand the problem.