Skip to main content
Version: v3

Return a phone app to an earlier revision.

POST 
/ai-builder-api/projects/:projectId/app-config/revisions/:revision/restore

Saves a copy of the earlier revision, screens included, as the newest one. Members get it once you publish it with POST .../app-config/publish.

Request​

Idempotency-Key stringrequired

A key you choose for this restore. Retrying with the same key returns the same restore instead of a second one.

Possible values: non-empty and <= 200 characters

Version stringrequired

The API version.

Available optionsv3
projectId stringrequired

The app's id.

Possible values: Value must match regular expression ^prj_[A-Za-z0-9_-]+$

revision integerrequired

The earlier revision to return to, from the app's revisions.

Possible values: >= 1

application/json

Bodyrequired

    baseRevisionintegerrequired

    The newest revision the caller saw (revision in the app's configuration). A save made since then refuses the restore instead of being overwritten.

    Possible values: >= 1

application/json

Restore revision queued for validation and preview publication.

Schema
    projectIdstringrequired

    Stable owner project for this location's shared ClientPortal Experience. It may differ from the web or mobile project in the current route.

    Possible values: Value must match regular expression ^prj_[A-Za-z0-9_-]+$

    revisionintegerrequired

    The newest saved revision. A finished run or a restore saves a new one.

    Possible values: >= 0

    appliedRevisionintegerrequired

    The newest revision that finished applying. Publish a revision once it equals revision and status is ready.

    Possible values: >= 0

    publishedRevisionintegerrequired

    The revision members get. 0 until the first publish.

    Possible values: >= 0

    statusAppCustomizationStatusrequired

    Where the newest revision is: ready once it has applied and can be published, failed when it could not apply.

    Available optionsidlequeuedapplyingreadyfailed
    previewUrlstring<uri>

    Where the latest applied revision can be previewed, when the app has a preview.

    lastErrorstring

    Why the latest revision failed to apply, when status is failed.

    createdAtstring<date-time>required

    When the app's configuration was first saved.

    updatedAtstring<date-time>required

    When the latest revision was saved or changed state.