adjust apis to give better feedback about configuring the workspaces.