Creates an empty root branch with no parent and no data. This is not a fork: the new branch starts from nothing, and its parent is null. Use branch.fork to start from an existing branch’s data. Creating a name that already exists fails with already_exists.engine.branch; names reserved for engine control data are rejected.

Successful mutations return an acknowledgement that identifies the affected target, the mutation effect, and commit facts when the operation changed stored state.

Examples

Create a new empty branch.

CLI

$ strata branch create feature
$ strata branch list

Wire

{"branch":"feature","type":"branch_create"}
{"type":"branch_list"}

Parameters

No parameters.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

MutationAck<BranchItem>.

Errors

• failed_precondition.engine.runtime_closed
• invalid_argument.engine.branch_name
• invalid_argument.engine.branch_name_reserved
• already_exists.engine.branch

Invocation

• CLI: strata branch create
• Wire type: branch_create