# Webbu API

> Webhook buffering and batched delivery API. Webbu receives webhooks, buffers them by a grouping key, and delivers batched payloads to configured HTTP destinations with retry and DLQ support.

## API Reference

### Ingest

- [POST /v1/ingest/{projectId}/{bufferId}](https://webbu.dev/api/docs#tag/ingest/POST/v1/ingest/{projectId}/{bufferId}): Ingest a webhook payload

### Projects

- [GET /v1/admin/projects](https://webbu.dev/api/docs#tag/projects/GET/v1/admin/projects): List projects
- [POST /v1/admin/projects](https://webbu.dev/api/docs#tag/projects/POST/v1/admin/projects): Create a project
- [GET /v1/admin/projects/{projectId}](https://webbu.dev/api/docs#tag/projects/GET/v1/admin/projects/{projectId}): Get a project
- [PATCH /v1/admin/projects/{projectId}](https://webbu.dev/api/docs#tag/projects/PATCH/v1/admin/projects/{projectId}): Update a project
- [DELETE /v1/admin/projects/{projectId}](https://webbu.dev/api/docs#tag/projects/DELETE/v1/admin/projects/{projectId}): Delete a project

### Buffers

- [GET /v1/admin/buffers](https://webbu.dev/api/docs#tag/buffers/GET/v1/admin/buffers): List buffers
- [POST /v1/admin/buffers](https://webbu.dev/api/docs#tag/buffers/POST/v1/admin/buffers): Create a buffer
- [GET /v1/admin/buffers/{bufferId}](https://webbu.dev/api/docs#tag/buffers/GET/v1/admin/buffers/{bufferId}): Get a buffer
- [PATCH /v1/admin/buffers/{bufferId}](https://webbu.dev/api/docs#tag/buffers/PATCH/v1/admin/buffers/{bufferId}): Update a buffer
- [DELETE /v1/admin/buffers/{bufferId}](https://webbu.dev/api/docs#tag/buffers/DELETE/v1/admin/buffers/{bufferId}): Delete a buffer
- [POST /v1/admin/buffers/{bufferId}/clone](https://webbu.dev/api/docs#tag/buffers/POST/v1/admin/buffers/{bufferId}/clone): Clone a buffer
- [POST /v1/admin/buffers/{bufferId}/test](https://webbu.dev/api/docs#tag/buffers/POST/v1/admin/buffers/{bufferId}/test): Test buffer delivery

### Analytics

- [GET /v1/analytics/summary](https://webbu.dev/api/docs#tag/analytics/GET/v1/analytics/summary): Get dashboard summary stats
- [GET /v1/analytics/timeseries](https://webbu.dev/api/docs#tag/analytics/GET/v1/analytics/timeseries): Get analytics timeseries data

### DLQ

- [GET /v1/dlq](https://webbu.dev/api/docs#tag/dlq/GET/v1/dlq): List dead letter queue items
- [GET /v1/dlq/{dlqId}](https://webbu.dev/api/docs#tag/dlq/GET/v1/dlq/{dlqId}): Get DLQ item details
- [DELETE /v1/dlq/{dlqId}](https://webbu.dev/api/docs#tag/dlq/DELETE/v1/dlq/{dlqId}): Delete a DLQ item
- [GET /v1/dlq/{dlqId}/batch](https://webbu.dev/api/docs#tag/dlq/GET/v1/dlq/{dlqId}/batch): Get the stored batch of a DLQ item
- [POST /v1/dlq/{dlqId}/retry](https://webbu.dev/api/docs#tag/dlq/POST/v1/dlq/{dlqId}/retry): Retry a DLQ item

### API Keys

- [GET /v1/admin/api-keys](https://webbu.dev/api/docs#tag/api-keys/GET/v1/admin/api-keys): List API keys
- [POST /v1/admin/api-keys](https://webbu.dev/api/docs#tag/api-keys/POST/v1/admin/api-keys): Create a new API key
- [DELETE /v1/admin/api-keys/{keyId}](https://webbu.dev/api/docs#tag/api-keys/DELETE/v1/admin/api-keys/{keyId}): Revoke an API key

### Credits

- [GET /v1/admin/credit-packs](https://webbu.dev/api/docs#tag/credits/GET/v1/admin/credit-packs): List credit packs
- [GET /v1/admin/credit-packs/{packId}/checkout-url](https://webbu.dev/api/docs#tag/credits/GET/v1/admin/credit-packs/{packId}/checkout-url): Get credit pack checkout URL
- [GET /v1/admin/credits](https://webbu.dev/api/docs#tag/credits/GET/v1/admin/credits): Get credit balance
- [POST /v1/admin/credits/add](https://webbu.dev/api/docs#tag/credits/POST/v1/admin/credits/add): Add credits (local emulator only)
- [GET /v1/admin/credits/transactions](https://webbu.dev/api/docs#tag/credits/GET/v1/admin/credits/transactions): Get credit transaction history

### Payments

- [GET /v1/admin/plans](https://webbu.dev/api/docs#tag/payments/GET/v1/admin/plans): List available subscription plans
- [GET /v1/admin/subscription](https://webbu.dev/api/docs#tag/payments/GET/v1/admin/subscription): Get current subscription
- [DELETE /v1/admin/subscription](https://webbu.dev/api/docs#tag/payments/DELETE/v1/admin/subscription): Cancel subscription (graceful)
- [DELETE /v1/admin/subscription/immediate](https://webbu.dev/api/docs#tag/payments/DELETE/v1/admin/subscription/immediate): Cancel subscription immediately
- [GET /v1/admin/invoices](https://webbu.dev/api/docs#tag/payments/GET/v1/admin/invoices): List invoices
- [GET /v1/admin/invoices/{invoiceId}](https://webbu.dev/api/docs#tag/payments/GET/v1/admin/invoices/{invoiceId}): Get invoice details
- [GET /v1/admin/subscription/checkout-url](https://webbu.dev/api/docs#tag/payments/GET/v1/admin/subscription/checkout-url): Get checkout URL

### Customers

- [POST /v1/admin/customers](https://webbu.dev/api/docs#tag/customers/POST/v1/admin/customers): Create a customer
- [GET /v1/admin/customers/{customerId}](https://webbu.dev/api/docs#tag/customers/GET/v1/admin/customers/{customerId}): Get a customer

### Health

- [GET /health](https://webbu.dev/api/docs#tag/health/GET/health): Health check

## Authentication

All authenticated endpoints require the `X-API-Key` header with a Webbu API key (prefix `wbk_`).

```
X-API-Key: wbk_your_api_key_here
```

## Documentation

- [Documentation](https://docs.webbu.dev/docs/): Guides, concepts, quickstart and error reference
- [API Reference (Interactive)](https://webbu.dev/api/docs): Scalar API reference with "Try It" playground
- [OpenAPI Spec](https://webbu.dev/api/openapi.json): Full OpenAPI 3.0 specification (JSON)
- [Full API Documentation](https://webbu.dev/api/llms-full.txt): Complete API documentation in plain text

## Servers

- Production: `https://webbu.dev/api`
- Local emulator: `http://localhost:5001/webhook-buffer/us-central1/api`