---
title: "Reschedule a notification queue entry"
method: POST
path: "/api/servicetodo/processes/notification-queue/{uuid}/reschedule"
tags: ["notificationQueue"]
---

# Reschedule a notification queue entry

`POST /api/servicetodo/processes/notification-queue/{uuid}/reschedule`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicetodo/processes/notification-queue/{uuid}/reschedule`
- Auth: HTTP bearer

Moves a planned or scheduled notification to a new future time. A planned reminder becomes scheduled. Gated behind the NOTIFICATIONS_V2 feature flag.

## Path parameters

- `uuid` string, uuid, required

## Request body

- object
  - `scheduledAt` string, date-time, required: ISO 8601 UTC. Must be in the future; otherwise the endpoint answers 400.

## Response `200`

Returns the rescheduled notification queue entry.

- object
  - `data` object, required
    - `uuid` string, uuid, required
    - `workerUuid` string, uuid, required
    - `workerDisplayName` string, required
    - `taskFlowUuid` string, uuid, required
    - `notificationType` 'initial' | 'deadline' | 'reminder' | 'newTask' | 'adHoc' | 'flowCompleted' | 'flowUpdated' | 'deadlineMissed', required
    - `channel` 'email' | 'sms', required
    - `status` 'upcoming' | 'sent' | 'cancelled' | 'skipped', required: The UI-facing status bucket (upcoming/sent/cancelled/skipped) — never the raw backend status.
    - `scheduledAt` string, date-time, required: ISO 8601 UTC. Converting to the viewer local timezone is a UI concern.
    - `sentAt` string, date-time, nullable, required
    - `cancelReason` 'workerTerminated' | 'workerOutOfTaskflow' | 'taskflowArchived' | 'taskflowCompleted' | 'taskflowSuperseded' | 'channelDisabled' | 'membershipGone' | 'workerLeftFlow' | 'workerAlreadyStarted': Why the notification was cancelled, when the cancel recorded a reason. Absent otherwise: an admin cancel records none.
  - `meta` ResponsesPartMeta, required
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `400`: default error response
- `403`: default error response
- `404`: default error response
- `409`: default error response

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)
