[Experimental]

Roll an app back to an existing deployment

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Deprecated: use POST /v1/services/{serviceId}/rollback instead.

Makes any eligible existing deployment live behind the app's stable endpoint (rollback or roll-forward). Unlike promote, a stopped target is started and waited until it is running before the endpoint is switched, so the currently-live deployment keeps serving with zero downtime. Returns the app endpoint domain.

post/v1/apps/{appId}/rollback

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/apps/{appId}/rollback
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://auth.prisma.io/authorize, token URL https://auth.prisma.io/token, scopes: workspace:admin, offline_access)
    • HTTP bearer

Path parameters

appIdstring required

Request body

deploymentIdstring
versionIdstring

Deprecated: use deploymentId instead. Ignored when deploymentId is also present.

Response

Deployment made live behind the app endpoint. The reassignedDomains field indicates how many custom domains were moved from the previously-live deployment to the new one.

Changes

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