HeyPuter/puter · error · HttpError

bad_request

bad_request

Error message

User ID required for puter_output_path

What it means

Error "User ID required for puter_output_path" thrown in HeyPuter/puter.

Source

Thrown at src/backend/drivers/ai-video/VideoGenerationDriver.ts:137

    }

    async generate(args: IGenerateVideoParams) {
        const actor = Context.get('actor') as Actor | undefined;
        if (!actor)
            throw new HttpError(401, 'Authentication required', {
                legacyCode: 'unauthorized',
            });

        const puterOutputPath = args.puter_output_path;
        delete args.puter_output_path;

        // Validate the output path early — before spending credits.
        let resolvedOutputPath: string | undefined;
        if (puterOutputPath) {
            const username = actor.user?.username;
            const userId = actor.user?.id;
            if (!userId || !username) {
                throw new HttpError(
                    400,
                    'User ID required for puter_output_path',
                    { legacyCode: 'bad_request' },
                );
            }
            resolvedOutputPath = this.#resolveOutputPath(
                puterOutputPath,
                username,
            );
            await this.#assertWriteAccess(actor, resolvedOutputPath);
        }

        if (args.model) {
            args.model = args.model.trim().toLowerCase();
        }

        const configuredProviders = Object.keys(this.#providers);
        if (configuredProviders.length === 0) {

View on GitHub (pinned to 908ec23eda)

Solutions

1. Ensure the actor context includes a user id when using puter_output_path.
2. Remove puter_output_path or call the driver as an authenticated user.

When it happens

Trigger: Thrown at src/backend/drivers/ai-video/VideoGenerationDriver.ts:137 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HeyPuter/puter@908ec23eda (2026-08-12). Data as JSON: /api/errors/a5650a77372efd3c. Report an issue: GitHub.