---
title: "Publish a mini-app preview entry"
method: POST
path: "/mini-apps/publish-preview"
tags: ["mini-apps"]
---

# Publish a mini-app preview entry

`POST /mini-apps/publish-preview`

Publishes a mini-app preview entry. Called by the mini-apps preview deploy pipeline to register a throwaway preview deploy, keyed by its unique preview id. Re-publishing an existing preview id refreshes every deploy-managed field. Preview entries are independent from the main catalog: they carry no slug, owner, or membership gating, and anyone with the preview link can access the app.

## Request body

- PublishMiniAppPreviewRequest — Artwork URLs used to present a mini-app in the app catalog.
  - `icon` string, nullable — Square mini-app icon URL.
  - `cover` string, nullable — Cover image or video URL used when no card artwork is available. Video URL paths must end in .mp4 or .webm.
  - `card` string, nullable — Preferred app catalog image or video thumbnail URL. Video URL paths must end in .mp4 or .webm.

## Response `200`

Mini-app preview published successfully

- PublishMiniAppPreviewResponse — Confirmation of a published mini-app preview entry.
  - `preview_id` string, required — Unique, URL-safe preview identifier composed by the deploy pipeline.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `503` — Service unavailable

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/b560c0ad0618/schema)