paperclipai/paperclip · error · ToolGatewayHttpError

gateway_token_not_found

gateway_token_not_found

Error message

MCP gateway token not found

What it means

Named gateway token management lookup: revokeNamedGatewayToken (or sibling token APIs) found no gateway token row for the supplied tokenId in this company. The 404 fires on the company-scoped select, covering deleted tokens and ids from other tenants.

Source

Thrown at server/src/services/tool-gateway.ts:4964

    let agentId = row.gateway.agentId;
    let runId: string | null = null;
    let responsibleUserId: string | null = null;
    let issueId = row.gateway.issueId;
    let projectId = row.gateway.projectId;
    if (row.token.subjectType === "heartbeat_run") {
      const tokenRunId = row.token.subjectId;
      if (!tokenRunId || !uuidPattern.test(tokenRunId)) {
        return recordNamedGatewayAuthFailure({
          gatewayId: input.gatewayId,
          gatewayPublicId: input.gatewayPublicId,
          bearerToken,
          reasonCode: "gateway_token_run_invalid",
          clientMetadata,
        });
      }
      const [run] = await db
        .select({
          companyId: heartbeatRuns.companyId,
          agentId: heartbeatRuns.agentId,
          status: heartbeatRuns.status,
          responsibleUserId: heartbeatRuns.responsibleUserId,
        })
        .from(heartbeatRuns)
        .where(eq(heartbeatRuns.id, tokenRunId))
        .limit(1);
      if (!run || run.companyId !== row.gateway.companyId) {
        return recordNamedGatewayAuthFailure({
          gatewayId: input.gatewayId,
          gatewayPublicId: input.gatewayPublicId,
          bearerToken,
          reasonCode: "gateway_token_run_invalid",
          clientMetadata,
        });
      }
      if (!ACTIVE_GATEWAY_RUN_STATUSES.has(run.status)) {
        return recordNamedGatewayAuthFailure({

View on GitHub (pinned to 01ad858492)

Solutions

1. The gateway token no longer exists (rotated or revoked). Re-authenticate to obtain a new token.

When it happens

Trigger: Thrown at server/src/services/tool-gateway.ts:4796 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/ba197e949ed61915. Report an issue: GitHub.