Skip to content
wabe Disk
View Markdown

Restore shared content as a new file state

POST/v1/disks/{disk}/restore
POST
/v1/disks/{disk}/restore
curl --request POST \
  --url https://api.wabe.sh/v1/disks/demo/restore \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "path": "/notes.txt", "version": "f75f43ae-8375-48f0-8bcd-862cb75c26ef" }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
disk
required
string
/^[A-Za-z0-9_-]{1,128}$/

Example 

demo

Project disk name, or the disk ID in the actor runtime disk URL.

Query Parameters

Section titled “Query Parameters”
branch
string
commit
string format: uuid
label
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
path
required
string
version
required
string format: uuid
expected_version
object
id
required
string format: uuid
revision
required
integer

Example 

{
  "path": "/notes.txt",
  "version": "f75f43ae-8375-48f0-8bcd-862cb75c26ef"
}

Responses

Section titled “Responses”

200

Section titled “200”

Metadata of the restored file.

Media typeapplication/json
object
version
required
Allowed value: 2
kind
required
One of:
Allowed value: Directory
object_id
required
string format: uuid
version_id
required
string format: uuid
branch_id
required

Origin of the version; inherited or imported versions may refer to an internal or deleted branch absent from the branch list.

string format: uuid
revision
required
integer
first_edit_at_ms
required
integer
last_edit_at_ms
required
integer
mode
required
integer
Allowed values: 16384 33188 33261 40960

400

Section titled “400”

Invalid input.

Media typetext/plain
string

401

Section titled “401”

Missing, invalid or revoked project API key, or an invalid runtime access token.

Media typeapplication/json
object
error
required
string
message
required
string

403

Section titled “403”

Actor runtime token does not authorize this disk or instance generation.

Media typeapplication/json
object
error
required
string
message
required
string

404

Section titled “404”

Object was not found.

Media typetext/plain
string

409

Section titled “409”

Conflict, nonempty destination or referenced object.

Media typetext/plain
string

500

Section titled “500”

Storage, I/O or corruption failure.

Media typetext/plain
string

503

Section titled “503”

Disk unavailable.

Media typeapplication/json
object
error
required
string
message
required
string