abhigyanpatwari/GitNexus · error

"path" must be a string

Error message

"path" must be a string

What it means

HTTP 400 returned by POST /api/analyze when the JSON body contains a "path" field whose value is not a string. The route destructures { url, path, force, embeddings, dropEmbeddings, token } from req.body and type-checks each optional field before creating a job, because the path value flows straight into the analysis worker as a filesystem location.

Solutions

1. Send path as one JSON string, e.g. {"path": "/home/me/repos/foo"}
2. Pick the string out of structured picker results (entries[0].fullPath), not the array or object
3. Omit the key when there is no local path rather than sending null
4. Double-check the Content-Type is application/json so the body is actually parsed

Example fix

// before
const body = { path: dirPicker.entries }; // array of picked entries

// after
const body = { path: dirPicker.entries[0].fullPath }; // single absolute path string

// Run before POSTing to /api/analyze
if ('path' in body && typeof body.path !== 'string') {
  throw new TypeError(`"path" must be a string, got ${typeof body.path}`);
}

const isMaybeString = (v: unknown): v is string | undefined =>
  v === undefined || typeof v === 'string';

On 400, inspect res.body.error — a type failure is deterministic per payload; correct the field (or omit it) before re-sending.

When it happens

Trigger: POST /api/analyze with {"path": null}, {"path": 42}, {"path": ["/repos/foo"]} or {"path": {"dir": "/repos/foo"}} — e.g. a directory picker returning an entries array, or a whole config object being sent where one of its string fields was intended.

Common situations: Browser/Electron folder pickers returning entry lists; YAML/env configs parsed into objects; serializers emitting null for undefined; URLSearchParams-style encoders producing arrays for scalar fields.

Related errors

• Missing "cypher" in request body
• "path" must be an absolute path
• Provide "url" (git URL) or "path" (local path)
• "url" must be a string
• Missing path

AI-assisted analysis of abhigyanpatwari/GitNexus@ac9a4e9abd (2026-08-20). Data as JSON: /api/errors/5a4f1895a0cf22b7. Report an issue: GitHub.

Appendix: source

Thrown at gitnexus/src/server/api.ts:1722

    async (req, res) => {
      try {
        const {
          url: repoUrl,
          path: repoLocalPath,
          force,
          embeddings,
          dropEmbeddings,
          springActuatorPath,
          asyncApiSpecPath,
          token: repoToken,
          branch: repoBranch,
        } = req.body;

        // Input type validation
        if (repoUrl !== undefined && typeof repoUrl !== 'string') {
          res.status(400).json({ error: '"url" must be a string' });
          return;
        }
        if (repoLocalPath !== undefined && typeof repoLocalPath !== 'string') {
          res.status(400).json({ error: '"path" must be a string' });
          return;
        }
        if (
          springActuatorPath !== undefined &&
          (typeof springActuatorPath !== 'string' || springActuatorPath.trim().length === 0)
        ) {
          res.status(400).json({ error: '"springActuatorPath" must be a non-empty string' });
          return;
        }
        if (
          asyncApiSpecPath !== undefined &&
          (typeof asyncApiSpecPath !== 'string' || asyncApiSpecPath.trim().length === 0)
        ) {
          res.status(400).json({ error: '"asyncApiSpecPath" must be a non-empty string' });
          return;
        }

View on GitHub (pinned to ac9a4e9abd)