paperclipai/paperclip · error

Query parameter 'path' is required

Error message

Query parameter 'path' is required

What it means

Param guard on GET /agents/:id/instructions-bundle/file: the required 'path' query parameter is missing or not a string, so the route cannot locate a file within the agent's instructions bundle and returns 400.

Source

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

      companyId,
      hireInput.adapterType,
      requestedAdapterConfig,
      withDefaultRoleSkillSelections(
        normalizeDesiredSkillSelections(Array.isArray(requestedDesiredSkills) ? requestedDesiredSkills : undefined),
        defaultRoleSkillSelections(hireInput.role, hireInput.adapterType),
      ),
      "add",
    );
    const normalizedAdapterConfig = await normalizeMediatedAdapterConfigForPersistence({
      companyId,
      adapterType: hireInput.adapterType,
      adapterConfig: desiredSkillAssignment.adapterConfig,
    });
    const normalizedRuntimeConfig = normalizeNewAgentRuntimeConfig(hireInput.runtimeConfig);
    const normalizedHireInput = {
      ...hireInput,
      adapterConfig: normalizedAdapterConfig,
      runtimeConfig: normalizedRuntimeConfig,
    };

    const company = await db
      .select()
      .from(companies)
      .where(eq(companies.id, companyId))
      .then((rows) => rows[0] ?? null);
    if (!company) {
      res.status(404).json({ error: "Company not found" });
      return;
    }

    // Idempotency within a run: if this run already created a hire from this
    // exact request, return that hire instead of creating a duplicate. The
    // creating agent cannot pause or delete its own hire (board-only), so a
    // doubled hire would otherwise strand a phantom teammate the board never
    // approved. The lookup, the create and the activity record run under one
    // lock per company + run, so two overlapping retries cannot both miss.

View on GitHub (pinned to 01ad858492)

Solutions

1. Include the 'path' query parameter in the request.

When it happens

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