---
title: "Update per-team match alert preferences"
method: PUT
path: "/api/user/team-alerts/{teamId}"
tags: ["User", "Notifications"]
---

# Update per-team match alert preferences

`PUT /api/user/team-alerts/{teamId}`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/user/team-alerts/{teamId}`
- Auth: HTTP bearer

Partial boolean body for kickoff, goals, periodEnd, final, lineups, and reminder. Unknown keys are ignored. Returns the full flag row. 404 when the user does not follow the team, including archived clubs. A missing row is created with schema defaults for omitted flags.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `kickoff` boolean
  - `goals` boolean
  - `periodEnd` boolean
  - `final` boolean
  - `lineups` boolean
  - `reminder` boolean

## Response `200`

{ success: true, data: { teamId, kickoff, goals, periodEnd, final, lineups, reminder } }

## Other responses

- `400`: { success: false, error, code: VALIDATION_ERROR }
- `401`: { success: false, error, code: UNAUTHORIZED }
- `404`: { success: false, error, code: NOT_FOUND }

## Changes

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

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/user/team-alerts/:teamId/put.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)
