API keys & customer agent

Customer-managed agents authenticate with Bearer tokens created in the app under Security.

Ingest endpoint

POST https://app-rust-delta-39.vercel.app/api/v1/ingest/events
Authorization: Bearer tp_...
Content-Type: application/json

Requirements

• Vercel env ENABLE_INGEST_API=true on the app project
• API key scope ingest:write
• Optional connector binding on key creation

Payload (minimal)

{
  "schemaVersion": "telegram.message.v1",
  "provider": "telegram",
  "eventType": "message.upsert",
  "externalSourceId": "-1001234567890",
  "externalItemId": "42",
  "idempotencyKey": "telegram:-100...:42:2026-01-01T00:00:00",
  "payload": { "id": 42, "date": "...", "text": "Hello" }
}

Events land in raw_ingest_events and are normalized by the processor cron (same pipeline as the platform collector).