API Reference
Bug0 provides a REST API for triggering tests and integrating with your CI/CD pipelines.
Base URL
https://app.bug0.com/api
Authentication
Bug0 API supports two authentication methods:
API Key (Recommended for CI/CD)
Include your API key in the x-api-key header:
curl -H "x-api-key: bug0_abc123..."
Service Token (Internal)
For internal service-to-service communication:
curl -H "x-bug0-service-token: your-token"
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
/run-tests | POST | Trigger test execution |
Rate Limits
| Limit | Value |
|---|---|
| Requests per minute | 10 |
| Requests per hour | 100 |
Rate limits are per project. Contact support for higher limits.
Response Format
All responses are JSON:
{
"success": true,
"message": "Tests triggered successfully",
"executionId": "abc123"
}
Error Responses
{
"success": false,
"error": "Invalid API key"
}
HTTP Status Codes
| Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad request (invalid parameters) |
| 401 | Unauthorized (invalid/missing API key) |
| 403 | Forbidden (no access to resource) |
| 404 | Not found |
| 429 | Rate limit exceeded |
| 500 | Server error |