---
title: "Change status of prospects (Mark prospect as replied, finished, paused, unsubscribed and active)"
method: PATCH
path: "/v1/prospects/status"
tags: ["prospects"]
---

# Change status of prospects (Mark prospect as replied, finished, paused, unsubscribed and active)

`PATCH /v1/prospects/status`

## Request body

- ProspectsUpdateStatusDto
  - `prospectAndSequenceIds` ProspectAndSequenceIdsDto[], required — array of prospect id and step id
    - `prospectId` string, required — prospect id of an existing prospect
    - `sequenceId` string, required — sequence id in which the related prospect id exists
  - `status` string, required — status type to update
  - `pauseDelayInDays` number — optional property to define pause delay in days in case of pausing prospects, only used when status=paused

## Response `200`

Prospect(s) status updated successfully<br><br>

- unknown

## Other responses

- `400` — 4000: Could not change prospects status<br><br>4001: Invalid sequence id or prospect id<br><br>
- `403` — 4003: You don't have required permissions to perform this task<br><br>
- `500` — 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)