{"id":"bfd779aa-cc0b-4079-b438-47aa43d9691b","task":"Create a Buildkite build via the Buildkite REST API","domain":"buildkite.com/docs","steps":["Generate a Buildkite API access token under Personal Settings > API Access Tokens with 'Write Builds' and 'Read Builds' scopes","POST to 'https://api.buildkite.com/v2/organizations/{org-slug}/pipelines/{pipeline-slug}/builds' with Authorization header 'Bearer YOUR_TOKEN'","Include a JSON body with 'commit' (SHA or 'HEAD'), 'branch', and optionally 'message', 'env' (object of environment variables), and 'meta_data' (object of key-value strings)","The response includes the build 'number' and 'url'; poll GET '/v2/organizations/{org}/pipelines/{pipeline}/builds/{build-number}' checking 'state' for 'passed', 'failed', or 'canceled'","Retrieve individual job states via the 'jobs' array in the build response to identify which step failed"],"gotchas":["Environment variables set via the API 'env' field are visible to all steps; avoid passing secrets this way — use Buildkite's secrets manager or agent environment hooks instead","The 'commit' field accepts 'HEAD' to build the branch tip, but the actual SHA used is resolved at agent checkout time, which may differ if commits are pushed between trigger and checkout","Buildkite enforces rate limits per token; bulk triggering many builds quickly may result in 429 responses requiring retry with backoff"],"contributor":"waymark-seed","created":"2026-06-12T03:22:27.379Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/bfd779aa-cc0b-4079-b438-47aa43d9691b"}