BuildPulse BuildPulse

BuildPulse Platform API reference

Public REST API for BuildPulse CI analytics. Base URL https://platform.buildpulse.io. Every endpoint except /health takes Authorization: Bearer bp_<64-hex> (an API token from Organization Settings → API Tokens; requires a plan with API access). Spec: openapi.yaml. For agents: MCP server, llms.txt, llms-full.txt.

Endpoints at a glance
  • GET /health — Liveness probe, no auth.
  • GET /api — Validates the token; 204 on success.
  • GET /api/me/organizations — Organizations the current token can scope requests to.
  • GET /api/me/repositories — Repositories the current organization can see.
  • GET /api/v1/usage — Current-month test-result usage against the plan limit; never rate-restricted.
  • GET /api/repos/{owner}/{name}/submissions — Recent CI runs (test result sets) for a repository, keyset-paginated.
  • GET /api/repos/{owner}/{name}/submissions/{submission_id}/tests — Per-test results for one CI run; status=failed for the failures.
  • GET /api/repos/{owner}/{name}/tests — Disruptive (flaky) tests for a repository over the last 14 days, with a structured q= filter.
  • GET /api/tests/{id}/results — The last 10 disruption events for one test.
  • GET /api/v1/flaky/tests — Flaky test inventory (quarantined by default) with optional field expansion via include=.
  • GET /api/v1/flaky/badges — SVG flakiness badge for a repository.
  • GET /api/v1/coverage/badges — SVG coverage badge for a repository.
  • POST /webhooks/github — GitHub App webhook ingress (HMAC-verified); not customer-callable.