paperclipai/paperclip · error · Error

Workspace job selection is required

Error message

Workspace job selection is required

What it means

Input guard in recordRuntimeControlOperation (action 'run'): the caller invoked the runtime control endpoint with action=run but workspaceCommand is missing or its kind is not 'job'. Running a workspace requires an explicit job selection, so the request is rejected before the workspace is made available.

Source

Thrown at server/src/routes/execution-workspaces.ts:576

            },
            issue: existing.sourceIssueId
              ? {
                  id: existing.sourceIssueId,
                  identifier: null,
                  title: existing.name,
                }
              : null,
            agent: {
              id: actor.agentId ?? null,
              name: actor.actorType === "user" ? "Board" : "Agent",
              companyId: existing.companyId,
            },
            recorder,
          });

        if (action === "run") {
          if (!workspaceCommand || workspaceCommand.kind !== "job") {
            throw new Error("Workspace job selection is required");
          }
          const availableWorkspace = await ensureWorkspaceAvailable();
          if (!availableWorkspace) {
            throw new Error("Execution workspace needs a local path before Paperclip can run workspace commands");
          }
          return await runWorkspaceJobForControl({
            actor: {
              id: actor.agentId ?? null,
              name: actor.actorType === "user" ? "Board" : "Agent",
              companyId: existing.companyId,
            },
            issue: existing.sourceIssueId
              ? {
                  id: existing.sourceIssueId,
                  identifier: null,
                  title: existing.name,
                }
              : null,

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Select a workspace job in the request before running workspace commands.

When it happens

Trigger: Thrown at server/src/routes/execution-workspaces.ts:389 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@a7e689b3c3 (2026-08-18). Data as JSON: /api/errors/7d2dede8ed3775ce. Report an issue: GitHub.