---
title: "Ingest behavioural feed signals"
method: POST
path: "/api/feed/signals"
tags: ["Feed"]
---

# Ingest behavioural feed signals

`POST /api/feed/signals`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/feed/signals`
- Auth: HTTP bearer

Authenticated. When UserSettings.analyticsPersonalization is false (#614), the payload is dropped at this endpoint and never persisted. Opted-in bodies are validated (zod) and stored as FeedSignal rows (#685): at most 50 events per request plus a 64KB body ceiling enforced before JSON parsing; unknown kind/filter rejected per event; dwellMs must be a finite positive number (booleans/numeric strings rejected), minimum normalized 1, clamped to 60s; opted-in writes are capped at 30 batches/min/user (429 RATE_LIMITED); client `at` clamped into the previous 24 hours ending at createdAt (future pinned to now). `accepted` counts the rows that survived validation (0 on the opt-out path). Rows older than FEED_SIGNAL_RETENTION_DAYS (default 90) are hard-deleted by the daily /api/cron/feed-signal-retention cron.

## Response `200`

{ success, data: { ingested: boolean, accepted: number } }

## Other responses

- `401`: Unauthenticated
- `413`: Body exceeds the 64KB ingest ceiling (PAYLOAD_TOO_LARGE)
- `429`: Per-user batch rate limit exceeded (RATE_LIMITED)

## Changes

- **2026-09-24** `01971acf764b`: 2 info
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
- **2026-09-12** `a8df6fe04343`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/feed/signals/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
