---
title: "Redistribute envelope"
method: POST
path: "/envelope/redistribute"
tags: ["Envelope"]
---

# Redistribute envelope

`POST /envelope/redistribute`

Redistribute the envelope to the provided recipients who have not actioned the envelope. Will use the distribution method set in the envelope. This also refreshes the signing-link expiration for the targeted unsigned recipients, renewing any expired links.

## Request body

- object
  - `envelopeId` string, required
  - `recipients` number[], required

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `id` string, required
  - `recipients` object[], required
    - `id` number, required
    - `name` string, required
    - `email` string, required
    - `token` string, required
    - `role` 'CC' | 'SIGNER' | 'VIEWER' | 'APPROVER' | 'ASSISTANT', required
    - `signingOrder` number, nullable, required
    - `signingUrl` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

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