Skip to content

Restore the app to a previous version (as a new commit)

POST
/api/workspaces/{workspaceId}/apps/{id}/restore
curl --request POST \
--url http://localhost:8080/api/workspaces/example/apps/example/restore \
--header 'Content-Type: application/json' \
--cookie auth_session=<auth_session> \
--data '{ "sha": "example" }'

Sets the app’s files back to their content at sha and commits that on the caller’s branch, then pushes. Nothing is rewritten: the versions in between stay in the history. Runs in the caller’s sandbox (starting it if needed), like any edit.

workspaceId
required
string
id
required
string
Media typeapplication/json
object
sha
required
string
/^[0-9a-f]{7,40}$/

Example generated

{
"sha": "example"
}

Successful response

Media typeapplication/json
object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
error
string

Example

{
"message": "Operation completed",
"error": "Error message"
}

Invalid request

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}

Internal server error

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}