Skip to content
Mailgun Inspect
/
API Reference
/
Email Preview
/
Update PreviewShare

Email Preview API (1.0.0)

Mailgun Email Preview service with RESTful JSON HTTP API for providing email previews.

Download OpenAPI description
openapi-final.json
openapi-final.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

https://api.eu.mailgun.net/

Email Preview

This API provides functionality to create and manage email preview tests, as well as create shareable links.

Operations

Get PreviewShare

Request

Returns PreviewShare record by TID.

Security
basicAuth
Path
test_idstringrequired

Test to get

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/preview/sharing/{test_id}'

Responses

A 200 response

Bodyapplication/json
test_idstringrequired
url_uuidstringrequired
urlstringrequired
enabledbooleanrequired
expires_atstring(date-time)required
Response
application/json
{
  "test_id": "some-test-id",
  "url_uuid": "some-uuid",
  "url": "share.mailgun.com/email-previews/some-uuid",
  "enabled": true,
  "expires_at": "0001-01-01 00:00:00 +0000 UTC"
}

Update PreviewShare

Request

Updates PreviewShare record enabled field.

Security
basicAuth
Path
test_idstringrequired

Test to update

Query
url_uuidstringrequired

UUID to update

curl -i -X PUT \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/preview/sharing/{test_id}?url_uuid=string'

Responses

A 200 response

Bodyapplication/json
messagestringrequired
Response
application/json
{
  "message": "record updated"
}

Delete PreviewShare

Request

Delete PreviewShare record by TID.

Security
basicAuth
Path
test_idstringrequired

Test to delete

Query
url_uuidstringrequired

UUID to delete

curl -i -X DELETE \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/preview/sharing/{test_id}?url_uuid=string'

Responses

A 200 response

Bodyapplication/json
messagestringrequired
Response
application/json
{
  "message": "record deleted"
}

Image Validation

The Image Validation API processes image URLs or uploads to provide comprehensive details such as dimensions, type, file size, and format, reports frame count, animation duration, color depth, and transparency for GIFs, and include image optimization capabilities.

Operations

Accessibility

The Accessibility API evaluates HTML emails against WCAG standards, providing a clear pass/fail assessment to ensure compliance with accessibility guidelines.

Operations