Export

Mint a one-time export download token

Returns a single-use download URL valid for 15 minutes. The raw token is never persisted server-side — only sha256(token) is stored. Re-downloading requires a fresh mint. Rate-limited to 10 mints per app per user per 24h.

This route hard-rejects includeSecrets: true with 400. Secrets export is browser-only and goes through the dashboard's password-confirm flow, which calls the internal /internal/exports/mint endpoint. The CLI, MCP, and any bearer-token client cannot produce a bundle containing env values.

post/apps/{appRef}/export/mint

Request

  • Base URL: https://api.percher.run
  • URL: https://api.percher.run/apps/{appRef}/export/mint
  • Auth: HTTP bearer

Path parameters

appRefstring required

Request body

deliveryKind'dashboard' | 'cli' | 'mcp' | 'sunset_email'
includeSecretsboolean

Must be omitted or false. Setting to true returns 400.

Response

Token minted

tokenIdstring
downloadUrlstring uri
expiresAtstring date-time
ttlSecondsinteger
includeSecretsboolean

Changes

No recorded changes to this operation across all 1 revision of this API.