API Reference
ButterStack provides APIs for integrating with your build pipeline and custom tooling.
API Types
Webhooks (Inbound)
Receive events from your tools (Perforce, Jenkins, etc.) via webhook endpoints.
REST API (Outbound)
Query and control ButterStack programmatically.
Authentication
All API endpoints require authentication:
- Webhooks: Token-based (
?token=YOUR_TOKEN) - REST API: Bearer token in Authorization header
Rate Limits
| Endpoint Type | Limit |
|---|---|
| Webhooks | 100 requests/minute |
| REST API | 60 requests/minute |
Rate limit headers are included in responses:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset