---
title: "Set warmup seed phrase"
method: PATCH
path: "/v1/warming/seed-phrase"
tags: ["Warming"]
---

# Set warmup seed phrase

`PATCH /v1/warming/seed-phrase`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/warming/seed-phrase`
- Auth: HTTP bearer

Sets the account-level warmup seed phrase and fans out signature updates
to every currently-warming mailbox asynchronously (one queued job per
campaign; the response returns immediately). New mailboxes pick the
phrase up when warming is enabled. Send an empty string to clear it.

## Request body

- object
  - `seed_phrase` string

## Response `200`

Seed phrase saved; signature updates queued

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `seed_phrase` string
    - `updated_at` string, date-time
    - `applied` integer: Always 0 — updates are applied asynchronously
    - `failed` integer: Campaigns that could not be queued
    - `remaining` integer: Campaigns queued for background update
    - `total` integer: Total warming campaigns

---

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