Skip to main content
POST
Transfer Ownership
Dashboard session only — outside the API key scope catalog, so an API key gets 403 API_KEY_SCOPE_DENIED. A key that could transfer ownership could be used to take over the workspace.
Ownership is possession, not a role: owner_id grants the full permission catalog without a row in workspace_member. Transferring it removes the new owner’s member row and creates one for the previous owner — seeded with the Admin role if it still exists, otherwise the first role by display position.

Path

string
required
Workspace ID.

Body

string
required
Must already be a member of the workspace.

Response

Same shape as Get Workspace, with the new owner_id.

Errors