langgenius/dify · error · FileUploadError

FormData is required for file uploads

Error message

FormData is required for file uploads

What it means

Error "FormData is required for file uploads" thrown in langgenius/dify.

Source

Thrown at sdks/nodejs-client/src/client/base.ts:178

      path: '/info',
      query: user ? { user } : undefined,
    })
  }

  getSite(user?: string): Promise<DifyResponse<JsonObject>> {
    if (user) {
      ensureNonEmptyString(user, 'user')
    }
    return this.http.request({
      method: 'GET',
      path: '/site',
      query: user ? { user } : undefined,
    })
  }

  fileUpload(form: unknown, user: string): Promise<DifyResponse<JsonObject>> {
    if (!isFormData(form)) {
      throw new FileUploadError('FormData is required for file uploads')
    }
    ensureNonEmptyString(user, 'user')
    appendUserToFormData(form, user)
    return this.http.request({
      method: 'POST',
      path: '/files/upload',
      data: form,
    })
  }

  filePreview(fileId: string, user: string, asAttachment?: boolean): Promise<DifyResponse<Buffer>> {
    ensureNonEmptyString(fileId, 'fileId')
    ensureNonEmptyString(user, 'user')
    return this.http.request<Buffer, 'bytes'>({
      method: 'GET',
      path: `/files/${fileId}/preview`,
      query: {
        user,

View on GitHub (pinned to ef8544b173)

When it happens

Trigger: Thrown at sdks/nodejs-client/src/client/base.ts:178 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of langgenius/dify@ef8544b173 (2026-08-12). Data as JSON: /api/errors/2625d5a88cb2a5ae. Report an issue: GitHub.