---
title: "Edit a Next Step"
method: PATCH
path: "/v3/next-steps/{id}"
tags: ["Next Steps"]
---

# Edit a Next Step

`PATCH /v3/next-steps/{id}`

Edits a task the user added themselves: its title, notes, category, or link. Only the fields sent are changed; send null for notes or link to clear them. SnowSEO's own suggestions cannot be edited and return 404. Use the priority endpoint to change how urgent it is.

## Path parameters

- `id` string, required

## Request body

- object
  - `teamId` string
  - `title` string — What needs doing, in one line.
  - `notes` string, nullable — Optional detail: why it matters, or how to do it.
  - `category` 'rankings' | 'technical' | 'content' | 'articles' | 'aiVisibility' | 'authority' — Which part of the work this belongs to.
  - `link` string, nullable — Optional link to open with the task: an in-app path or an http(s) URL.

## Other responses

- `400` — Default Response
- `404` — Default Response

---

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