paperclipai/paperclip · error

Type "${adapterType}" is not a builtin adapter.

Error message

Type "${adapterType}" is not a builtin adapter.

What it means

Type guard on the override-pause route: the requested :type names a builtin adapter type that has no external plugin override installed, so there is no external override to pause/resume and the route returns 400.

Source

Thrown at server/src/routes/adapters.ts:500

   *
   * Pause or resume an external adapter's override of a builtin type.
   * When paused, the server returns the builtin adapter for all new requests
   * (execute, listModels, config schema, etc.).  Already-running sessions
   * keep the adapter they started with.
   */
  router.patch("/adapters/:type/override", async (req, res) => {
    assertInstanceAdmin(req);

    assertAdapterManagementVisible();

    const adapterType = req.params.type;
    const { paused } = req.body as { paused?: boolean };

    if (typeof paused !== "boolean") {
      res.status(400).json({ error: "\"paused\" (boolean) is required in request body." });
      return;
    }

    if (!BUILTIN_ADAPTER_TYPES.has(adapterType)) {
      res.status(400).json({ error: `Type "${adapterType}" is not a builtin adapter.` });
      return;
    }

    const changed = setOverridePaused(adapterType, paused);

    logger.info({ type: adapterType, paused, changed }, "Adapter override toggle");

    res.json({ type: adapterType, paused, changed });
  });

  /**
   * DELETE /api/adapters/:type
   *
   * Unregister an external adapter. Built-in adapters cannot be removed.
   */
  router.delete("/adapters/:type", async (req, res) => {

View on GitHub (pinned to 5716fe907e)

Solutions

1. Use a builtin adapter type for this operation, or install the adapter externally first.

When it happens

Trigger: Thrown at server/src/routes/adapters.ts:445 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@5716fe907e (2026-08-18). Data as JSON: /api/errors/6991a8d7657055a3. Report an issue: GitHub.