{"record":{"id":"99f7162880edeb5f","repo":"langgenius/dify","slug":"errorcode-usageinvalidflag","errorCode":"ErrorCode.UsageInvalidFlag","errorMessage":"--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID","messagePattern":"--workspace value (.+?) is not a valid UUID","errorType":"exception","errorClass":"BaseError","httpStatus":null,"severity":"error","filePath":"cli/src/workspace/resolver.ts","lineNumber":20,"sourceCode":"import { BaseError } from '@/errors/base'\nimport { ErrorCode } from '@/errors/codes'\n\nexport type WorkspaceResolveInputs = {\n  readonly flag?: string\n  readonly env?: string\n  readonly active?: ActiveContext\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nexport function isValidUuid(v: string): boolean {\n  return UUID_RE.test(v)\n}\n\nexport function resolveWorkspaceId(inputs: WorkspaceResolveInputs): string {\n  if (truthy(inputs.flag)) {\n    if (!isValidUuid(inputs.flag))\n      throw new BaseError({\n        code: ErrorCode.UsageInvalidFlag,\n        message: `--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID`,\n      })\n    return inputs.flag\n  }\n  if (truthy(inputs.env)) {\n    if (!isValidUuid(inputs.env))\n      throw new BaseError({\n        code: ErrorCode.UsageInvalidFlag,\n        message: `DIFY_WORKSPACE_ID value ${JSON.stringify(inputs.env)} is not a valid UUID`,\n      })\n    return inputs.env\n  }\n  const wsId = inputs.active?.ctx.workspace?.id\n  if (truthy(wsId)) {\n    if (!isValidUuid(wsId)) {\n      throw new BaseError({\n        code: ErrorCode.UsageInvalidFlag,","sourceCodeStart":2,"sourceCodeEnd":38,"githubUrl":"https://github.com/langgenius/dify/blob/ef8544b173fd6cd7a8e71df2cab576e52bebbfbc/cli/src/workspace/resolver.ts#L2-L38","documentation":"Error \"--workspace value ${JSON.stringify(inputs.flag)} is not a valid UUID\" thrown in langgenius/dify.","triggerScenarios":"Thrown at cli/src/workspace/resolver.ts:20 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"ef8544b173fd6cd7a8e71df2cab576e52bebbfbc","analyzedAt":"2026-08-12T05:15:17.394Z","schemaVersion":2},"datasetVersion":"2026-08-12T13:17:24.610Z"}