paperclipai/paperclip · error

Board access required

Error message

Board access required

What it means

403 guard on POST /issues/:id/admin/force-release. Fires when the actor is not a board user; the admin force-release escape hatch (releasing a stuck checkout) is board-only and never exposed to agent keys.

Source

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

        try {
          const existingWake = await findExistingIssueBlockersResolvedWakeForReadyState(db, {
            companyId: issue.companyId,
            dependentIssueId: input.dependentIssueId,
            blockerIssueIds: input.blockerIssueIds,
            blockedTransitionAt: input.blockedTransitionAt,
          });
          if (existingWake) return;
        } catch (err) {
          logger.warn(
            { err, issueId: input.dependentIssueId, idempotencyKey },
            "failed to check existing dependency wake before issue update wake",
          );
        }
        addWakeup(input.agentId, {
          source: "automation",
          triggerDetail: "system",
          reason: ISSUE_BLOCKERS_RESOLVED_WAKE_REASON,
          payload: {
            issueId: input.dependentIssueId,
            resolvedBlockerIssueId: input.resolvedBlockerIssueId,
            blockerIssueIds: input.blockerIssueIds,
            mutation: input.mutation,
          },
          idempotencyKey,
          requestedByActorType: actor.actorType,
          requestedByActorId: actor.actorId,
          contextSnapshot: {
            issueId: input.dependentIssueId,
            taskId: input.dependentIssueId,
            wakeReason: ISSUE_BLOCKERS_RESOLVED_WAKE_REASON,
            source: input.source,
            resolvedBlockerIssueId: input.resolvedBlockerIssueId,
            blockerIssueIds: input.blockerIssueIds,
          },
        });
      };

View on GitHub (pinned to 01ad858492)

Solutions

1. Include the required field(s) in the request path, query, or body as named by the error message, then retry.
2. Check the API contract in packages/shared validators for the exact required shape of this endpoint.

When it happens

Trigger: Thrown at server/src/routes/issues.ts:10771 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/b2fb285584f62112. Report an issue: GitHub.