Adjuntos y carpetas

Los adjuntos de esta API son links con una etiqueta. Los PDFs que forman parte de la firma se gestionan como archivos del sobre.

Añade un link adjuntoCopiar link al encabezado

curl --fail-with-body \
  'https://business.digito.do/api/v2/envelope/attachment/create' \
  -H "Authorization: $DIGITO_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
  "envelopeId": "envelope_ejemplo",
  "data": {
    "label": "Condiciones del servicio",
    "data": "https://example.com/condiciones"
  }
}'

data.data es la URL y data.label es su etiqueta. La respuesta devuelve un id de adjunto. Evita links con secretos, recursos privados de otro cliente o documentos temporales que desaparecerán durante el proceso.

GET /envelope/attachment?envelopeId=... lista los adjuntos. Las operaciones /update y /delete de este recurso utilizan el identificador del adjunto según la referencia.

Crea una carpetaCopiar link al encabezado

curl --fail-with-body \
  'https://business.digito.do/api/v2/folder/create' \
  -H "Authorization: $DIGITO_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "Contratos 2026",
  "type": "DOCUMENT"
}'

Guarda el id devuelto. Usa parentId para crear una carpeta dentro de otra. Las carpetas pueden ser de documentos o de plantillas; verifica el type y el equipo antes de relacionarlas con un sobre.

Para mover un sobre, actualiza data.folderId mediante POST /envelope/update. Para modificar una carpeta, usa POST /folder/update con folderId y data.

GET /folder admite filtros de búsqueda, tipo y carpeta padre, y devuelve la misma estructura de paginación que la lista de sobres. Eliminar una carpeta es una operación distinta de eliminar un sobre; consulta su contrato y revisa el contenido antes de ejecutarla.

Referencia de adjuntos · Referencia de carpetas.

Relaciona el sobre con la carpetaCopiar link al encabezado

Después de comprobar el equipo y tipo de la carpeta, este cuerpo mueve un sobre existente mediante POST /envelope/update:

{
  "envelopeId": "envelope_ejemplo",
  "data": {
    "folderId": "folder_ejemplo"
  }
}

Una carpeta organiza el recurso; no cambia quién está autorizado para firmarlo. Conserva la relación en tu sistema si necesitas navegar por expedientes y aplica paginación al consultar colecciones grandes.