# BuildPulse Auth API

**Canonical:** https://apis.io/apis/buildpulse-io/buildpulse-io-auth-api/  
**Provider:** BuildPulse — https://apis.io/providers/buildpulse-io/  
**Base URL:** https://platform.buildpulse.io  
**Documentation:** https://platform.buildpulse.io/docs/

BuildPulse Auth API is one of 7 APIs that [BuildPulse](https://apis.io/providers/buildpulse-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Token validation and caller identity. Send an API token as `Authorization: Bearer bp_<64-hex>` (or `Authorization: token …`). Tokens are created under Organization Settings → API Tokens and shown once; they are bound to one organization and require a plan with API access. Hosted-MCP OAuth sessions use the same endpoints and may span several organizations, selected with `?organization_id=`. This tag also covers the account-scoped reads: the organizations and repositories the caller can see, and the organization's current usage against its plan.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/api` | Validate an API token |
| GET | `/api/me/organizations` | List organizations accessible to the current token |
| GET | `/api/me/repositories` | List repositories the current organization can see |
| GET | `/api/v1/usage` | Current test-result usage for the organization |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/buildpulse-io/openapi/buildpulse-io-auth-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-submissions-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-submission-tests-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-flaky-tests-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-tests-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-test-results-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildpulse-io/json-schema/buildpulse-io-health-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/buildpulse-io/apis.yml

## Other BuildPulse APIs (6)

- [BuildPulse Badges API](https://apis.io/apis/buildpulse-io/buildpulse-io-badges-api/)
- [BuildPulse Flaky API](https://apis.io/apis/buildpulse-io/buildpulse-io-flaky-api/)
- [BuildPulse Health API](https://apis.io/apis/buildpulse-io/buildpulse-io-health-api/)
- [BuildPulse Submissions API](https://apis.io/apis/buildpulse-io/buildpulse-io-submissions-api/)
- [BuildPulse Tests API](https://apis.io/apis/buildpulse-io/buildpulse-io-tests-api/)
- [BuildPulse Webhooks API](https://apis.io/apis/buildpulse-io/buildpulse-io-webhooks-api/)

## Tags

Authentication

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/buildpulse-io/buildpulse-io-auth-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/buildpulse-io/.