Create independently writable branch

POST

/v1/disks/{disk}/branches

curl --request POST \
  --url https://api.wabe.sh/v1/disks/demo/branches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "work", "from": "7bdd0f94-3d70-4367-8d5d-1cdbec118598" }'

Authorizations

• bearerAuth
• runtimeAccess

Parameters

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.

Request Body^required

Media typeapplication/json

object

name

required

string

from

required

string format: uuid

Example

{
  "name": "work",
  "from": "7bdd0f94-3d70-4367-8d5d-1cdbec118598"
}

Responses

200

New branch metadata.

Media typeapplication/json

object

id

required

string format: uuid

name

required

string

root_directory_id

required

string format: uuid

revision

required

integer

base_commit

required

string | null format: uuid

head_commit

required

string | null format: uuid

400

Invalid input.

Media typetext/plain

string

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

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

Media typeapplication/json

object

error

required

string

message

required

string

404

Object was not found.

Media typetext/plain

string

409

Conflict, nonempty destination or referenced object.

Media typetext/plain

string

500

Storage, I/O or corruption failure.

Media typetext/plain

string

503

Disk unavailable.

Media typeapplication/json

object

error

required

string

message

required

string