paperclipai/paperclip · error · ToolGatewayHttpError

run_company_mismatch

run_company_mismatch

Error message

Run does not belong to company

What it means

Tenant guard on run resolution: the heartbeatRuns row for runId is missing or its companyId differs from the caller's company. Enforces company scoping for run-context lookups; the foreign runId is at fault.

Source

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

        applicationKey,
        applicationDisplayName: application.name,
        connectionId: connection.id,
        catalogEntryId: catalogEntry.id,
        transport: connection.transport,
        gatewayToolName,
        upstreamToolName: catalogEntry.toolName,
        catalogName: catalogEntry.name,
        inputSchema,
        outputSchema,
        annotations,
        risk: {
          level: catalogEntry.riskLevel,
          isReadOnly: catalogEntry.isReadOnly,
          isWrite: catalogEntry.isWrite,
          isDestructive: catalogEntry.isDestructive,
        },
        onDemandTools,
      };
      return {
        name: gatewayToolName,
        displayName: catalogEntry.title ?? catalogEntry.toolName,
        description: catalogEntry.description ?? `Connected MCP tool ${catalogEntry.toolName} from ${connection.name}.`,
        parametersSchema: inputSchema,
        pluginId: `mcp:${applicationKey ?? application.id}`,
        providerType: connection.transport === "local_stdio" ? "mcp_local_stdio" : "mcp_remote_http",
        risk,
        applicationId: application.id,
        applicationKey,
        applicationDisplayName: application.name,
        connectionId: connection.id,
        catalogEntryId: catalogEntry.id,
        upstreamToolName: catalogEntry.toolName,
        providerMetadata,
      };
    });
  }

View on GitHub (pinned to 01ad858492)

Solutions

1. Use a run ID that belongs to the authenticated company; cross-company run access is rejected.

When it happens

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