Kong/insomnia · error

Invalid reflection server api key

Error message

Invalid reflection server api key

What it means

gRPC reflection error mapping in getMethodsFromReflectionServer: the reflection server responded with the Connect Unauthenticated code, meaning the configured reflection server API key is invalid or missing. The raw connect error is normalized to this message for the renderer.

Solutions

  1. Correct the reflection server API key in the gRPC request settings
  2. Verify the key has reflection access on the server
  3. Regenerate the key if it was revoked
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at packages/insomnia/src/main/ipc/grpc.ts:208 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Kong/insomnia@d9bb2b0142 (2026-08-26). Data as JSON: /api/errors/32e1f86949bd5e97. Report an issue: GitHub.

Appendix: source

Thrown at packages/insomnia/src/main/ipc/grpc.ts:208

      return [];
    }
    const packageDefinition = protoLoader.loadFileDescriptorSetFromBuffer(
      Buffer.from(res.fileDescriptorSet.toBinary()),
    );
    for (const definition of Object.values(packageDefinition)) {
      const serviceDefinition = asServiceDefinition(definition);
      if (serviceDefinition === null) {
        continue;
      }
      const serviceMethods = Object.values(serviceDefinition);
      methodDefs.push(...serviceMethods);
    }
    return methodDefs;
  } catch (error) {
    const connectError = ConnectError.from(error);
    switch (connectError.code) {
      case Code.Unauthenticated: {
        throw new Error('Invalid reflection server api key');
      }
      case Code.NotFound: {
        throw new Error(
          "The reflection server api key doesn't have access to the module or the module does not exists",
        );
      }
      default: {
        throw error;
      }
    }
  }
};
const getMethodsFromReflection = async (
  host: string,
  metadata: GrpcRequestHeader[],
  rejectUnauthorized: boolean,
  reflectionApi: GrpcRequest['reflectionApi'],
  disableUserAgentHeader: boolean,

View on GitHub (pinned to d9bb2b0142)