API Usage

POST /pitch

Enqueue a message to Redis Streams.

Request

curl -X POST http://localhost:8080/pitch \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test-message",
    "repository": "my-repo",
    "payload": {"key": "value"}
  }'

Response (Success)

{
  "status": "success",
  "message": "Message enqueued",
  "objectID": "1234567890-0"
}

Response (Error)

{
  "status": "error",
  "message": "Failed to enqueue message to Redis"
}

Authentication Errors

Missing or invalid token returns 401 Unauthorized:

{
  "status": "error",
  "message": "Missing Authorization header"
}

POST /pitch/grafana

Accept Grafana webhook contact point payloads and enqueue each alert as a message.

Request

Configure a Grafana webhook contact point with the URL https://<pitcher-host>/pitch/grafana and add the Authorization: Bearer $AUTH_TOKEN header.

Grafana sends payloads automatically when alerts fire or resolve. Each alert is mapped to a homerun.Message:

Grafana field	Message field
labels.alertname	title
annotations.summary / description	message
labels.severity + status	severity
startsAt	timestamp
receiver	system
dashboardURL / panelURL / generatorURL	url
remaining labels	tags (comma-separated)

Response (Success)

{
  "status": "success",
  "message": "2 of 2 alerts enqueued",
  "results": [
    {"objectId": "...", "streamId": "messages", "status": "success", "message": "Alert abc123 enqueued"}
  ],
  "errors": []
}

Response (Partial failure)

If some alerts fail to enqueue but others succeed, the endpoint returns 200 with error details:

{
  "status": "success",
  "message": "1 of 2 alerts enqueued",
  "results": [...],
  "errors": ["alert xyz: redis connection refused"]
}

Response (Total failure)

If all alerts fail, the endpoint returns 503:

{
  "status": "error",
  "message": "Failed to enqueue all alerts",
  "errors": ["alert xyz: redis connection refused"]
}

POST /pitch/github

Accept GitHub webhook payloads and enqueue each event as a message.

Request

Configure a GitHub webhook on your repository or organization:

• Payload URL: https://<pitcher-host>/pitch/github
• Content type: application/json
• Secret: optional, set GITHUB_WEBHOOK_SECRET to enable HMAC-SHA256 signature validation

The X-GitHub-Event header determines the event type. Supported events:

Event	Title format	Severity
push	Push to org/repo:branch	info
pull_request	PR #N action: title	success (merged), info (other)
issues	Issue #N action: title	info
release	Release action: tag	success
workflow_run	Workflow name: action	success/critical/warning by conclusion

Unknown events are accepted with a generic mapping.

Response (Success)

{
  "objectId": "...",
  "streamId": "messages",
  "status": "success",
  "message": "GitHub push event enqueued"
}

Ping Event

GitHub sends a ping event when a webhook is first configured. The endpoint responds with:

{
  "status": "success",
  "message": "pong"
}

GET /health

Returns 200 OK when the service is running.

Response

{
  "status": "ok"
}

Environment Variables

Variable	Default	Description
PORT	8080	HTTP server port
REDIS_ADDR	redis-stack.homerun2.svc.cluster.local	Redis server address
REDIS_PORT	6379	Redis server port
REDIS_STREAM	messages	Redis stream name
REDIS_SEARCH_INDEX	(empty)	RediSearch index name (enables dual-write)
GITHUB_WEBHOOK_SECRET	(empty)	HMAC secret for GitHub webhook validation
AUTH_TOKEN	(required)	Bearer token for auth
REDIS_PASSWORD	(optional)	Redis password