Update A Return Envelope

  1. API Docs
  2. Return Envelopes
  3. Update A Return Envelope

Renames or re-describes one of your return envelopes. Template PDFs, PNG proofs, and billing attributes are staff-managed: uploading a file is refused with 403, and fields such as envelope_type, postage_applied, cost_per_unit, or active are not accepted on this endpoint.

Parameters
Parameter Type Required Default Description
name String Sometimes N/A New display name (max 255 characters). Required only when provided.
description String No N/A New description.
Sample Response
{{
  "id": 7,
  "client_id": 1100,
  "company_name": "Demo Company",
  "name": "Windowed Reply Envelope",
  "description": "#9 windowed reply envelope",
  "sku": "RE9-W",
  "envelope_type": "Windowed",
  "postage_applied": true,
  "cost_per_unit": 0.55,
  "sheet_count": 1,
  "weight_oz": 0.4,
  "duplex": false,
  "color": false,
  "active": true,
  "has_template": true,
  "template_preview": {{
    "file_type": "PDF",
    "metadata_url": "https://next-api.checkissuing.com/return-envelopes/7/template/metadata",
    "preview_url_template": "/return-envelopes/7/template/previews/{{pageNumber}}",
    "view_url": "https://next-api.checkissuing.com/return-envelopes/7/template"
  }},
  "has_png_scan": true,
  "png_scan_url": "https://next-api.checkissuing.com/return-envelopes/7/png-scan?v=1a2b3c4d5e6f7a8b",
  "deleted": false,
  "created_at": "2026-09-05 10:00:00",
  "updated_at": "2026-09-05 10:00:00",
  "deleted_at": null
}}