---
title: "Generate an Electronic Seal Image Preview"
method: POST
path: "/electronic_seal_images/preview"
tags: ["Electronic Seal Image"]
---

# Generate an Electronic Seal Image Preview

`POST /electronic_seal_images/preview`

Generate a PNG preview of an Electronic Seal Image based on the given field dimensions,
an optional uploaded image, and an optional caption.
This allows integrators to visualize the seal rendering before creating an Electronic Seal.

**This endpoint is only available in Sandbox environment.**

## Request body

- CreateElectronicSealImagePreviewPayload
  - `image_id` string, uuid, nullable — The ID of an existing Electronic Seal Image to use as the visual stamp.
  - `field` CreateElectronicSealImagePreviewPayloadField, required — The seal field dimensions and optional caption.
    - `width` integer, required — Width of the seal field in pixels.
    - `height` integer, required — Height of the seal field in pixels.
    - `captions` CreateElectronicSealImagePreviewPayloadFieldCaptionsInner[], nullable — Optional captions to display on the seal image. Limited to one caption per field.
      - `text` string, required — The caption text to display on the seal image.

## Response `200`

OK

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)