# Reminders

## Create

**post** `/v1/chats/{chatID}/reminders`

Set a reminder for a chat at a specific time

### Path Parameters

- `chatID: string`

  Unique identifier of the chat.

### Body Parameters

- `reminder: object { remindAtMs, dismissOnIncomingMessage }`

  Reminder configuration

  - `remindAtMs: number`

    Unix timestamp in milliseconds when reminder should trigger

  - `dismissOnIncomingMessage: optional boolean`

    Cancel reminder if someone messages in the chat

### Example

```http
curl http://localhost:23373/v1/chats/$CHAT_ID/reminders \
    -H 'Content-Type: application/json' \
    -d '{
          "reminder": {
            "remindAtMs": 0
          }
        }'
```

## Delete

**delete** `/v1/chats/{chatID}/reminders`

Clear an existing reminder from a chat

### Path Parameters

- `chatID: string`

  Unique identifier of the chat.

### Example

```http
curl http://localhost:23373/v1/chats/$CHAT_ID/reminders \
    -X DELETE
```