No default instructions path key for adapter type '${existin

Error message

No default instructions path key for adapter type '${existing.adapterType}'. Provide adapterConfigKey.

What it means

Resolution failure in the instructions-path route: updating the agent's instructions source needs a config key to write to, the adapter type has no default instructions path key, and the request did not supply an explicit adapterConfigKey — so there is no destination for the update.

Source

Thrown at server/src/routes/agents.ts:3997

    const actor = getActorInfo(req);
    const updated = await svc.rollbackConfigRevision(id, revisionId, {
      agentId: actor.agentId,
      userId: actor.actorType === "user" ? actor.actorId : null,
    });
    if (!updated) {
      res.status(404).json({ error: "Revision not found" });
      return;
    }

    await logActivity(db, {
      companyId: updated.companyId,
      actorType: actor.actorType,
      actorId: actor.actorId,
      agentId: actor.agentId,
      runId: actor.runId,
      agentApiKeyId: actor.agentApiKeyId,
      action: "agent.config_rolled_back",
      entityType: "agent",
      entityId: updated.id,
      details: { revisionId },
    });

    res.json(redactAgentRowForResponse(updated));
  });

  router.get("/agents/:id/runtime-state", async (req, res) => {
    assertBoard(req);
    const id = req.params.id as string;
    const agent = await getAccessibleResource(req, res, svc.getById(id), "Agent not found");
    if (!agent) return;
    await assertBoardCanManageAgentsForCompany(req, agent.companyId);

    const state = await heartbeat.getRuntimeState(id);
    res.json(state);
  });

View on GitHub (pinned to 01ad858492)

Solutions

Provide adapterConfigKey explicitly for this adapter type, since it has no default instructions path key.

Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at server/src/routes/agents.ts:3536 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/a29cb2d34bc9354e. Report an issue: GitHub.