API reference
Tally is a small HTTP API that stores per-row scores and answers ranking questions.
What Tally does
Tally stores numeric scores keyed by (scope_key, rule_key, row_key) and exposes ranking, percentile, and top-N queries.
- Idempotent ingest by composite key — re-runs are safe.
- Server-side ranking via Postgres window functions.
- Four tie-resolution policies.
- Per-row TTLs with automatic cleanup.
Concepts
scope — a logical bucket (campaign, table, project). Auto-created on first ingest.
rule — a named scoring dimension within a scope (e.g. intent_score). Auto-created on first ingest.
row_key — caller-supplied identifier (lead id, account domain, Clay row id).
Limits
Bulk ingest: up to 1,000 rows per request (413 above).
Leaderboard: max 1,000 rows per page (keyset pagination).
Rate limiting: not enforced in v1 — please be reasonable.