Creates a product space in the branch catalog. Creation is idempotent: creating a space that already exists succeeds with created: false and no mutation effect. Names reserved for engine control data are rejected with invalid_argument.engine.product_space_reserved.

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 product space.

CLI

$ strata space create app
$ strata space list

Wire

{"space":"app","type":"space_create"}
{"type":"space_list"}

Parameters

No parameters.

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

Returns

MutationAck<SpaceCreate>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.product_space_reserved

Invocation

• CLI: strata space create
• Wire type: space_create