---
title: "Save a negative feed preference"
method: POST
path: "/api/feed/preferences"
tags: ["Feed"]
---

# Save a negative feed preference

`POST /api/feed/preferences`

## Request

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

Authenticated. Body { subjectType, subjectId, kind }. 201 { success, data: { id, subjectType, subjectId, kind, createdAt } }. Idempotent on (subjectType, subjectId): one row per pair, and a repeat with a different kind updates that row (still 201, returned kind matches the request). subjectId is trimmed, 1–200 characters, no NUL; unknown keys are rejected (400 VALIDATION_ERROR). Cap is 200 rows per user across both surfaces; a new pair at the cap is 409 PREFERENCE_CAP and the oldest row is kept. A replay of an existing pair does not count toward the cap. creative is stored on the promoted surface; every other subjectType is organic. Writes (this POST and DELETE) share a 30/minute/user limit (429 RATE_LIMITED). A missing User row is 404 NOT_FOUND.

## Request body

- object
  - `subjectType` 'author' | 'team' | 'topic' | 'itemType' | 'creative', required
  - `subjectId` string, required
  - `kind` 'less' | 'never', required

## Response `201`

{ success, data: FeedPreference } including idempotent replay; kind matches the request

## Other responses

- `400`: Invalid body (VALIDATION_ERROR)
- `401`: Unauthenticated
- `404`: User row missing (NOT_FOUND)
- `409`: Per-user cap of 200 reached (PREFERENCE_CAP)
- `429`: Write rate limit exceeded (RATE_LIMITED)

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/feed/preferences/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)
