---
title: "Change the lead time or the channels of a pending reminder"
method: PUT
path: "/rest/api/v1/projects/{projectId}/calendarAlerts/{alertId}"
tags: ["News API"]
---

# Change the lead time or the channels of a pending reminder

`PUT /rest/api/v1/projects/{projectId}/calendarAlerts/{alertId}`

## Request

- Base URL: `https://api.metacopier.io`
- URL: `https://api.metacopier.io/rest/api/v1/projects/{projectId}/calendarAlerts/{alertId}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/projects/:projectId/calendarAlerts/:alertId/put.ts> (a function with typed inputs; its response is checked against the schema)

Only a bell can be edited. Warnings of a news feature and rows materialised from a rule follow their source.

## Path parameters

- `projectId` string, uuid, required
- `alertId` string, required

## Request body

- CalendarAlertDTO: Armed reminder for an economic calendar event
  - `accountId` string, uuid: Account the warning is about, null for a plain calendar reminder
  - `createdAt` string, date-time: Creation time
  - `createdByEmail` string: Who armed the row, provenance only and never a scope
  - `eventId` string: Id of the calendar event this alert points at
  - `eventTimeUtc` string, date-time: Event time the fire time was computed from
  - `eventTitle` string: Event title at arming time, for the alert list
  - `featureId` string, uuid: Originating news feature instance, null for a bell
  - `fireAtUtc` string, date-time: When the alert becomes due
  - `id` string: MongoDB document id
  - `kind` 'BELL' | 'RULE' | 'FILTER_WARNING' | 'AGENDA': Which producer created the row
  - `leadMinutes` integer: Minutes before the event the alert fires
  - `notificationTargets` NotificationTargetDTO[]: Where the alert is delivered
    - `featureId` string, uuid: Id of the channel feature instance, for example the project's Telegram feature
    - `recipient` string: Null means every recipient of that channel. Telegram: the username. Email: the address. Slack, Discord, Teams and webhook always leave this null.
  - `projectId` string, uuid: Owning project
  - `ruleId` string: Originating standing rule, null unless kind is RULE
  - `sent` boolean: True once the alert has been claimed and dispatched

## Response `200`

OK

- CalendarAlertDTO: Armed reminder for an economic calendar event
  - `accountId` string, uuid: Account the warning is about, null for a plain calendar reminder
  - `createdAt` string, date-time: Creation time
  - `createdByEmail` string: Who armed the row, provenance only and never a scope
  - `eventId` string: Id of the calendar event this alert points at
  - `eventTimeUtc` string, date-time: Event time the fire time was computed from
  - `eventTitle` string: Event title at arming time, for the alert list
  - `featureId` string, uuid: Originating news feature instance, null for a bell
  - `fireAtUtc` string, date-time: When the alert becomes due
  - `id` string: MongoDB document id
  - `kind` 'BELL' | 'RULE' | 'FILTER_WARNING' | 'AGENDA': Which producer created the row
  - `leadMinutes` integer: Minutes before the event the alert fires
  - `notificationTargets` NotificationTargetDTO[]: Where the alert is delivered
    - `featureId` string, uuid: Id of the channel feature instance, for example the project's Telegram feature
    - `recipient` string: Null means every recipient of that channel. Telegram: the username. Email: the address. Slack, Discord, Teams and webhook always leave this null.
  - `projectId` string, uuid: Owning project
  - `ruleId` string: Originating standing rule, null unless kind is RULE
  - `sent` boolean: True once the alert has been claimed and dispatched

## Changes

- **2026-08-30** `69d2d39c695e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/projects/:projectId/calendarAlerts/:alertId/put.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) - [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacopier/apis/metacopier-api/revisions/2ac6d7461345?raw)