Authentication
Snell employs cryptographic request signing to ensure the integrity and origin of incoming telemetry arrays. All API calls altering state or ingesting signals require a valid HMAC-SHA256 hash.
x-snell-signature
The signature is generated as a hex string by hashing the literal JSON request payload using your environment's SNELL_SECRET_KEY.
const crypto = require('crypto');
const signature = crypto
.createHmac('sha256', process.env.SNELL_SECRET_KEY)
.update(JSON.stringify(payload))
.digest('hex');Endpoints & Webhooks
POST/api/v1/collect
Ingests a raw telemetry signal from an edge client into the latent routing queue.
- * intent
- String (friction | request | praise) classifying the underlying urgency.
- * raw_text
- String max 2000 chars. PII will be irreversibly scrubbed on ingestion.
- traits
- JSON Object. Supported keys: mrr, plan_tier. Used for Boardroom aggregation.
- customer_id
- String (UUID). Requires valid HMAC signature to process.
DELETE/api/v1/gdpr/user
Article 17 Right To Be Forgotten webhook. Permanently purges all metrics tied to an identity.
- * customer_id
- String (UUID). The pseudonymized identifier of the user to eradicate.
- Return
- 200 OK. { deleted_rows: Int }