---
title: "Create Reminder"
method: POST
path: "/api/v1/assistant/requests"
tags: ["Collection Assistant"]
---

# Create Reminder

`POST /api/v1/assistant/requests`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/assistant/requests`
- Auth: HTTP bearer

## Headers

- `X-App-Version` string, nullable

## Request body

- CreateReminderIn
  - `gem_id` integer, required
  - `kind` 'reminder'
  - `due_at` string, date-time, nullable
  - `timezone` string, nullable
  - `purpose` string, nullable
  - `note` string, nullable

## Response `201`

Successful Response

- ReminderOut
  - `id` integer, required
  - `gem_id` integer, required
  - `kind` 'reminder' | 'attention', required
  - `status` string, required
  - `criteria` object
  - `due_at` string, date-time, nullable
  - `timezone` string, nullable
  - `closed_reason` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)