Create workspace

Overview

useCreateWorkspace returns a callable that creates a workspace. The signed-in caller becomes the owner. Omit parentWorkspaceId for a root workspace (requires a verified email); pass it for a child (requires the create-sub-workspace capability on the parent).

The verified-email gate on root creation is absolute — there is no server-side escape hatch. A service or master key acting as a named user via the node SDK is held to the same rule, exactly as accepting an invite and receiving an ownership transfer are. Prompt the user through email verification before showing a “Create workspace” flow.

Usage Example

import { useCreateWorkspace } from "@sublay/react-js";

function CreateTeam() {
  const createWorkspace = useCreateWorkspace();

  const handleCreate = async () => {
    const workspace = await createWorkspace({ name: "Acme Inc" });
    console.log("Created:", workspace.id, "owner:", workspace.ownerId);
  };
}

Error codes

Code	Status	Meaning
`workspace/email-not-verified`	403	Root creation, and the caller’s email is not verified.
`workspace/unauthorized`	403	Child creation, and you lack `create-sub-workspace` on the parent.
`workspace/not-found`	404	The `parentWorkspaceId` does not exist in this project.
`workspace/max-depth-exceeded`	400	The child would sit deeper than the 10-level nesting cap.

Overview

Auth Hooks

Current User

User Profiles

Entities

Entity Lists

Spaces

Spaces — Rules

Space Lists

Workspaces

Events

Comments

Reactions

Follows

Connections

Blocks

Collections

App Notifications

Push Notifications

Chat — Conversations

Chat — Messages

Chat — Core

Search

Reports

Storage

Crypto

Project

Custom Tables

Overview

Usage Example

Parameters

Returns

Error codes

​Overview

​Usage Example

​Parameters

​Returns

​Error codes

​Related

Overview

Usage Example

Parameters

Returns

Error codes

Related