paperclipai/paperclip · error

Entering blocked requires unresolved blockers, a pending int

Error message

Entering blocked requires unresolved blockers, a pending interaction/approval, or unblockDescriptor

What it means

422 on status change to blocked. Fires when the caller requests status=blocked but none of the preconditions hold: no unresolved dependency blockers, no pending thread interaction, no pending approval, and no unblockDescriptor supplied — the blocked state must be backed by at least one of these.

Source

Thrown at server/src/routes/issues.ts:10069

    await assertCanManageIssueMonitor(access, req, issue.companyId, issue.assigneeAgentId, true);

    const actor = getActorInfo(req);
    await heartbeat.triggerIssueMonitor(issue.id, {
      actorType: actor.actorType,
      actorId: actor.actorId,
      agentId: actor.agentId ?? null,
      runId: actor.runId ?? null,
    });

    res.json({ ok: true });
  });

  router.post("/issues/:id/scheduled-retry/retry-now", async (req, res) => {
    assertBoard(req);
    const id = req.params.id as string;
    const issue = await getAccessibleResource(req, res, svc.getById(id), "Issue not found");
    if (!issue) return;

    const actor = getActorInfo(req);
    const result = await heartbeat.retryScheduledRetryNow({
      issueId: issue.id,
      actor: {
        actorType: actor.actorType,
        actorId: actor.actorId,
      },
    });

    await logActivity(db, {
      companyId: issue.companyId,
      actorType: actor.actorType,
      actorId: actor.actorId,
      action: "issue.scheduled_retry_retry_now",
      entityType: "issue",
      entityId: issue.id,
      agentId: result.scheduledRetry?.agentId ?? issue.assigneeAgentId ?? null,
      runId: result.scheduledRetry?.runId ?? null,

View on GitHub (pinned to 01ad858492)

Solutions

1. Correct the request so it satisfies the condition stated in the error message, then retry; see the throwing line in the named file for the exact check.

When it happens

Trigger: Thrown at server/src/routes/issues.ts:9388 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/41ebb6382195aef0. Report an issue: GitHub.