# Envelopes

> Operaciones adicionales sobre envelopes más allá de crear, distribuir y consultar.

La [Guía de Integración](/guides/integration-guide/) cubre el flujo mínimo: crear, distribuir, consultar estado y descargar. Este recurso documenta el resto de las operaciones sobre un envelope — listar con filtros, actualizar, cancelar, duplicar, reenviar y consultar varios a la vez.

## Listar envelopes

```http
GET /envelope
```

Devuelve una lista paginada. Acepta estos parámetros de consulta:

| Parámetro | Valores | Descripción |
|---|---|---|
| `query` | texto | Búsqueda libre por título u otros campos indexados. |
| `page` / `perPage` | número | Paginación (`perPage` por defecto 10). |
| `type` | `DOCUMENT`, `TEMPLATE` | Filtra por tipo de envelope. |
| `templateId` | número | Solo envelopes creados a partir de esa plantilla. |
| `source` | `DOCUMENT`, `TEMPLATE`, `TEMPLATE_DIRECT_LINK` | Filtra por origen de creación. |
| `status` | `DRAFT`, `PENDING`, `COMPLETED`, `REJECTED`, `CANCELLED` | Filtra por estado. |
| `hasExpiredRecipients` | `true`, `false` | Solo envelopes con algún destinatario cuyo enlace de firma expiró. |
| `folderId` | string | Filtra por carpeta. |
| `orderByColumn` / `orderByDirection` | `createdAt` / `asc`, `desc` | Orden del listado. |

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-find/).

## Consultar varios envelopes

```http
POST /envelope/get-many
```

Recibe un arreglo `ids` y devuelve el detalle de cada uno en una sola llamada — útil para evitar N llamadas a `GET /envelope/{envelopeId}` cuando ya tienes los IDs (por ejemplo, después de crear varios documentos desde una plantilla).

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-getmany/).

## Actualizar un envelope

```http
POST /envelope/update
```

Modifica `data` (propiedades del envelope, como `title` o `externalId`) y/o `meta` (asunto, mensaje, `redirectUrl`, etc.) de un envelope existente. Solo tiene efecto mientras el envelope está en `DRAFT` — una vez distribuido, estas propiedades quedan fijas.

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-update/).

## Cancelar un envelope

```http
POST /envelope/cancel
```

Cancela un envelope en curso (`DRAFT` o `PENDING`), con un `reason` opcional. A diferencia de un rechazo (que lo origina un destinatario), la cancelación la origina el dueño del envelope.

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-cancel/).

## Eliminar un envelope

```http
POST /envelope/delete
```

Elimina un envelope. Un envelope `COMPLETED` no se puede eliminar — cancélalo antes si todavía no llegó a ese estado.

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-delete/).

## Duplicar un envelope

```http
POST /envelope/duplicate
```

Crea una copia de un envelope existente. Los flags `includeRecipients` e `includeFields` controlan si la copia trae también los destinatarios y campos originales, o queda en blanco para configurarla desde cero.

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-duplicate/).

## Reenviar a destinatarios pendientes

```http
POST /envelope/redistribute
```

Vuelve a notificar a destinatarios específicos de un envelope ya distribuido — por ejemplo, si no vieron el correo original o su enlace expiró. Recibe `recipients`, la lista de destinatarios a renotificar.

Ver la especificación completa en la [Referencia de la API](/api/operations/envelope-redistribute/).

---

## Ver también

- [Destinatarios](/resources/recipients/) — agregar y gestionar quién firma
- [Campos](/resources/fields/) — tipos de campo y sus opciones
- [Plantillas](/resources/templates/) — crear envelopes reutilizables