coder · ssncferreira · Jul 15, 2025 · Jul 10, 2025 · Jul 10, 2025 · Jul 10, 2025
diff --git a/cli/testdata/coder_list_--output_json.golden b/cli/testdata/coder_list_--output_json.golden
@@ -86,6 +86,7 @@
     "automatic_updates": "never",
     "allow_renames": false,
     "favorite": false,
-    "next_start_at": "====[timestamp]====="
+    "next_start_at": "====[timestamp]=====",
+    "is_prebuild": false
   }
 ]
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/coderd/workspaces.go b/coderd/workspaces.go
@@ -2231,6 +2231,7 @@ func convertWorkspace(
 	if latestAppStatus.ID == uuid.Nil {
 		appStatus = nil
 	}
+
 	return codersdk.Workspace{
 		ID:                                   workspace.ID,
 		CreatedAt:                            workspace.CreatedAt,
@@ -2265,6 +2266,7 @@ func convertWorkspace(
 		AllowRenames:     allowRenames,
 		Favorite:         requesterFavorite,
 		NextStartAt:      nextStartAt,
+		IsPrebuild:       workspace.IsPrebuild(),
 	}, nil
 }
 

diff --git a/codersdk/workspaces.go b/codersdk/workspaces.go
@@ -66,6 +66,12 @@ type Workspace struct {
 	AllowRenames     bool             `json:"allow_renames"`
 	Favorite         bool             `json:"favorite"`
 	NextStartAt      *time.Time       `json:"next_start_at" format:"date-time"`
+	// IsPrebuild indicates whether the workspace is a prebuilt workspace.
+	// Prebuilt workspaces are owned by the prebuilds system user and have specific behavior,
+	// such as being managed differently from regular workspaces.
+	// Once a prebuilt workspace is claimed by a user, it transitions to a regular workspace,
+	// and IsPrebuild returns false.
+	IsPrebuild bool `json:"is_prebuild"`
 }
 
 func (w Workspace) FullName() string {

diff --git a/docs/reference/api/schemas.md b/docs/reference/api/schemas.md
diff --git a/docs/reference/api/workspaces.md b/docs/reference/api/workspaces.md
diff --git a/site/src/api/typesGenerated.ts b/site/src/api/typesGenerated.ts
diff --git a/site/src/pages/WorkspaceSettingsPage/WorkspaceSchedulePage/WorkspaceSchedulePage.stories.tsx b/site/src/pages/WorkspaceSettingsPage/WorkspaceSchedulePage/WorkspaceSchedulePage.stories.tsx
@@ -0,0 +1,93 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { getAuthorizationKey } from "api/queries/authCheck";
+import { templateByNameKey } from "api/queries/templates";
+import { workspaceByOwnerAndNameKey } from "api/queries/workspaces";
+import type { Workspace } from "api/typesGenerated";
+import {
+	reactRouterNestedAncestors,
+	reactRouterParameters,
+} from "storybook-addon-remix-react-router";
+import {
+	MockPrebuiltWorkspace,
+	MockTemplate,
+	MockUserOwner,
+	MockWorkspace,
+} from "testHelpers/entities";
+import { withAuthProvider, withDashboardProvider } from "testHelpers/storybook";
+import { WorkspaceSettingsLayout } from "../WorkspaceSettingsLayout";
+import WorkspaceSchedulePage from "./WorkspaceSchedulePage";
+
+const meta = {
+	title: "pages/WorkspaceSchedulePage",
+	component: WorkspaceSchedulePage,
+	decorators: [withAuthProvider, withDashboardProvider],
+	parameters: {
+		layout: "fullscreen",
+		user: MockUserOwner,
+	},
+} satisfies Meta<typeof WorkspaceSchedulePage>;
+
+export default meta;
+type Story = StoryObj<typeof WorkspaceSchedulePage>;
+
+export const RegularWorkspace: Story = {
+	parameters: {
+		reactRouter: workspaceRouterParameters(MockWorkspace),
+		queries: workspaceQueries(MockWorkspace),
+	},
+};
+
+export const PrebuiltWorkspace: Story = {
+	parameters: {
+		reactRouter: workspaceRouterParameters(MockPrebuiltWorkspace),
+		queries: workspaceQueries(MockPrebuiltWorkspace),
+	},
+};
+
+function workspaceRouterParameters(workspace: Workspace) {
+	return reactRouterParameters({
+		location: {
+			pathParams: {
+				username: `@${workspace.owner_name}`,
+				workspace: workspace.name,
+			},
+		},
+		routing: reactRouterNestedAncestors(
+			{
+				path: "/:username/:workspace/settings/schedule",
+			},
+			<WorkspaceSettingsLayout />,
+		),
+	});
+}
+
+function workspaceQueries(workspace: Workspace) {
+	return [
+		{
+			key: workspaceByOwnerAndNameKey(workspace.owner_name, workspace.name),
+			data: workspace,
+		},
+		{
+			key: getAuthorizationKey({
+				checks: {
+					updateWorkspace: {
+						object: {
+							resource_type: "workspace",
+							resource_id: MockWorkspace.id,
+							owner_id: MockWorkspace.owner_id,
+						},
+						action: "update",
+					},
+				},
+			}),
+			data: { updateWorkspace: true },
+		},
+		{
+			key: templateByNameKey(
+				MockWorkspace.organization_id,
+				MockWorkspace.template_name,
+			),
+			data: MockTemplate,
+		},
+	];
+}
diff --git a/site/src/pages/WorkspaceSettingsPage/WorkspaceSchedulePage/WorkspaceSchedulePage.tsx b/site/src/pages/WorkspaceSettingsPage/WorkspaceSchedulePage/WorkspaceSchedulePage.tsx
@@ -7,6 +7,7 @@ import { Alert } from "components/Alert/Alert";
 import { ErrorAlert } from "components/Alert/ErrorAlert";
 import { ConfirmDialog } from "components/Dialogs/ConfirmDialog/ConfirmDialog";
 import { displayError, displaySuccess } from "components/GlobalSnackbar/utils";
+import { Link } from "components/Link/Link";
 import { Loader } from "components/Loader/Loader";
 import { PageHeader, PageHeaderTitle } from "components/PageHeader/PageHeader";
 import dayjs from "dayjs";
@@ -20,6 +21,7 @@ import { type FC, useState } from "react";
 import { Helmet } from "react-helmet-async";
 import { useMutation, useQuery, useQueryClient } from "react-query";
 import { useNavigate, useParams } from "react-router-dom";
+import { docs } from "utils/docs";
 import { pageTitle } from "utils/page";
 import { WorkspaceScheduleForm } from "./WorkspaceScheduleForm";
 import {
@@ -32,7 +34,7 @@ const permissionsToCheck = (workspace: TypesGen.Workspace) =>
 		updateWorkspace: {
 			object: {
 				resource_type: "workspace",
-				resourceId: workspace.id,
+				resource_id: workspace.id,
 				owner_id: workspace.owner_id,
 			},
 			action: "update",
@@ -94,42 +96,62 @@ const WorkspaceSchedulePage: FC = () => {
 				</Alert>
 			)}
 
-			{template && (
-				<WorkspaceScheduleForm
-					template={template}
-					error={submitScheduleMutation.error}
-					initialValues={{
-						...getAutostart(workspace),
-						...getAutostop(workspace),
-					}}
-					isLoading={submitScheduleMutation.isPending}
-					defaultTTL={dayjs.duration(template.default_ttl_ms, "ms").asHours()}
-					onCancel={() => {
-						navigate(`/@${username}/${workspaceName}`);
-					}}
-					onSubmit={async (values) => {
-						const data = {
-							workspace,
-							autostart: formValuesToAutostartRequest(values),
-							ttl: formValuesToTTLRequest(values),
-							autostartChanged: scheduleChanged(
-								getAutostart(workspace),
-								values,
-							),
-							autostopChanged: scheduleChanged(getAutostop(workspace), values),
-						};
-
-						await submitScheduleMutation.mutateAsync(data);
-
-						if (
-							data.autostopChanged &&
-							getAutostop(workspace).autostopEnabled
-						) {
-							setIsConfirmingApply(true);
-						}
-					}}
-				/>
-			)}
+			{template &&
+				(workspace.is_prebuild ? (
+					<Alert severity="info">
+						Prebuilt workspaces ignore workspace-level scheduling until they are
+						claimed. For prebuilt workspace specific scheduling refer to the{" "}
+						<Link
+							title="Prebuilt Workspaces Scheduling"
+							href={docs(
+								"/admin/templates/extending-templates/prebuilt-workspaces#scheduling",
+							)}
+							target="_blank"
+							rel="noreferrer"
+						>
+							Prebuilt Workspaces Scheduling
+						</Link>
+						documentation page.
+					</Alert>
+				) : (
+					<WorkspaceScheduleForm
+						template={template}
+						error={submitScheduleMutation.error}
+						initialValues={{
+							...getAutostart(workspace),
+							...getAutostop(workspace),
+						}}
+						isLoading={submitScheduleMutation.isPending}
+						defaultTTL={dayjs.duration(template.default_ttl_ms, "ms").asHours()}
+						onCancel={() => {
+							navigate(`/@${username}/${workspaceName}`);
+						}}
+						onSubmit={async (values) => {
+							const data = {
+								workspace,
+								autostart: formValuesToAutostartRequest(values),
+								ttl: formValuesToTTLRequest(values),
+								autostartChanged: scheduleChanged(
+									getAutostart(workspace),
+									values,
+								),
+								autostopChanged: scheduleChanged(
+									getAutostop(workspace),
+									values,
+								),
+							};
+
+							await submitScheduleMutation.mutateAsync(data);
+
+							if (
+								data.autostopChanged &&
+								getAutostop(workspace).autostopEnabled
+							) {
+								setIsConfirmingApply(true);
+							}
+						}}
+					/>
+				))}
 
 			<ConfirmDialog
 				open={isConfirmingApply}

diff --git a/site/src/testHelpers/entities.ts b/site/src/testHelpers/entities.ts
@@ -1411,6 +1411,14 @@ export const MockWorkspace: TypesGen.Workspace = {
 	deleting_at: null,
 	dormant_at: null,
 	next_start_at: null,
+	is_prebuild: false,
+};
+
+export const MockPrebuiltWorkspace = {
+	...MockWorkspace,
+	owner_name: "prebuilds",
+	name: "prebuilt-workspace",
+	is_prebuild: true,
 };
 
 export const MockFavoriteWorkspace: TypesGen.Workspace = {