paperclipai/paperclip · error

SETUP_TOKEN_START_FAILED

SETUP_TOKEN_START_FAILED

Error message

The setup-token login session could not start.

What it means

The setup-token login session could not be started: the spine's start step failed (session creation or login bootstrap error) after validation and guards passed; treated as a retryable session-start failure.

Source

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

      return;
    }
    const agent = await svc.remove(id);
    if (!agent) {
      res.status(404).json({ error: "Agent not found" });
      return;
    }

    await logActivity(db, {
      companyId: agent.companyId,
      actorType: "user",
      actorId: req.actor.userId ?? "board",
      action: "agent.deleted",
      entityType: "agent",
      entityId: agent.id,
    });

    res.json({ ok: true });
  });

  router.get("/agents/:id/keys", async (req, res) => {
    assertBoard(req);
    const id = req.params.id as string;
    const agent = await getAccessibleAgent(req, res, id);
    if (!agent) {
      return;
    }
    const keys = await svc.listKeys(id);
    res.json(keys);
  });

  router.post("/agents/:id/keys", validate(createAgentKeySchema), async (req, res) => {
    assertBoard(req);
    const id = req.params.id as string;
    const agent = await getAccessibleAgent(req, res, id);
    if (!agent) {
      return;

View on GitHub (pinned to 01ad858492)

Solutions

1. Retry the login start
2. Check server logs for the underlying session-start error
3. Verify adapter login dependencies are available on the host

When it happens

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

Common situations: See trigger scenarios.

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