paperclipai/paperclip · error

API route not found

Error message

API route not found

What it means

API catch-all in createApp: the request matched the /api mount but no registered route handled its method+path, so Express fell through to the terminal middleware which returns a uniform 404 JSON error. It is a router fallback, not a thrown exception.

Source

Thrown at server/src/app.ts:671

          if (handle) handle.notify(method, params);
        };
        const services = buildHostServices(db, pluginId, manifest.id, eventBus, notifyWorker, {
          pluginWorkerManager: workerManager,
          manifest,
        });
        hostServicesDisposers.set(pluginId, () => services.dispose());
        return createHostClientHandlers({
          pluginId,
          capabilities: manifest.capabilities,
          services,
        });
      },
    },
  );
  runtimePluginLoader = loader;
  api.use(
    toolGatewayRoutes(db, toolGateway),
  );
  api.use(
    pluginRoutes(
      db,
      loader,
      { scheduler, jobStore },
      { workerManager },
      { toolDispatcher },
      { workerManager },
      { toolGateway },
    ),
  );
  api.use(adapterRoutes({
    getNativeRunnerEnabled: async () =>
      (await instanceSettingsService(db).getExperimental()).enableNativeRunner === true,
  }));
  api.use(
    accessRoutes(db, {
      deploymentMode: opts.deploymentMode,

View on GitHub (pinned to 01ad858492)

Solutions

1. Check the request path and method against the API routes; correct the URL and retry.

When it happens

Trigger: Thrown at server/src/app.ts:661 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/0f4419bb26e2e4e4. Report an issue: GitHub.