paperclipai/paperclip · error

User secret definition not found

Error message

User secret definition not found

What it means

Error "User secret definition not found" thrown in paperclipai/paperclip.

Source

Thrown at server/src/routes/secrets.ts:669

      const definitionId = req.params.definitionId as string;
      assertSecretDefinitionAdmin(req, companyId);

      const updated = await svc.updateUserSecretDefinition(
        companyId,
        definitionId,
        {
          key: req.body.key,
          name: req.body.name,
          description: req.body.description,
          status: req.body.status,
          providerConfigId: req.body.providerConfigId,
          providerMetadata: req.body.providerMetadata,
          usageGuidance: req.body.usageGuidance,
        },
        boardActorUser(req),
      );
      if (!updated) {
        res.status(404).json({ error: "User secret definition not found" });
        return;
      }
      const activityActor = userSecretDefinitionActivityActor(req);
      const activityAction = req.body.status === "deleted"
        ? "user_secret_definition.deleted"
        : "user_secret_definition.updated";

      await logActivity(db, {
        companyId,
        actorType: activityActor.actorType,
        actorId: activityActor.actorId,
        action: activityAction,
        entityType: "user_secret_definition",
        entityId: updated.id,
        details: { key: updated.key, status: updated.status },
      });

      res.json(updated);

View on GitHub (pinned to 01ad858492)

Solutions

1. Define the user secret first, then set or read its value.
2. Check the secret name/key for typos against the list of defined user secrets.

When it happens

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

Common situations: Returned when a secret operation references a user secret definition that does not exist.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/f576ae74e0ddec7c. Report an issue: GitHub.