langgenius/dify · error · BaseError

ErrorCode.UsageInvalidFlag

ErrorCode.UsageInvalidFlag

Error message

--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID

What it means

Error "--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID" thrown in langgenius/dify.

Source

Thrown at cli/src/workspace/resolver.ts:20

import { BaseError } from '@/errors/base'
import { ErrorCode } from '@/errors/codes'

export type WorkspaceResolveInputs = {
  readonly flag?: string
  readonly env?: string
  readonly active?: ActiveContext
}

const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i

export function isValidUuid(v: string): boolean {
  return UUID_RE.test(v)
}

export function resolveWorkspaceId(inputs: WorkspaceResolveInputs): string {
  if (truthy(inputs.flag)) {
    if (!isValidUuid(inputs.flag))
      throw new BaseError({
        code: ErrorCode.UsageInvalidFlag,
        message: `--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID`,
      })
    return inputs.flag
  }
  if (truthy(inputs.env)) {
    if (!isValidUuid(inputs.env))
      throw new BaseError({
        code: ErrorCode.UsageInvalidFlag,
        message: `DIFY_WORKSPACE_ID value ${JSON.stringify(inputs.env)} is not a valid UUID`,
      })
    return inputs.env
  }
  const wsId = inputs.active?.ctx.workspace?.id
  if (truthy(wsId)) {
    if (!isValidUuid(wsId)) {
      throw new BaseError({
        code: ErrorCode.UsageInvalidFlag,

View on GitHub (pinned to ef8544b173)

When it happens

Trigger: Thrown at cli/src/workspace/resolver.ts:20 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/99f7162880edeb5f. Report an issue: GitHub.