---
title: "Refresh Next Steps"
method: POST
path: "/v3/next-steps/refresh"
tags: ["Next Steps"]
---

# Refresh Next Steps

`POST /v3/next-steps/refresh`

Recomputes the team's recommended steps from the latest data. Runs in the background and is rate-limited per team; the updated list appears shortly after. Pass engine="ai" to also run the cross-source AI synthesis pass, which costs AI credits; omitting it uses the team's saved default.

## Request body

- object
  - `teamId` string
  - `engine` 'data' | 'ai'

## Response `200`

Default Response

- object
  - `ok` boolean, required
  - `enqueued` boolean
  - `jobId` string
  - `engine` string

## Changes

- **2026-08-25** `bdd9f2dbc54d` — 2 info
  - added the new optional request property `engine`
  - added the optional property `engine` to the response with the `200` status

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/next-steps/refresh/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/86840800b2f3/schema)