BLACKBOX_AUTH_REQUIRED

BLACKBOX_AUTH_REQUIRED

Error message

Blackbox session is not authenticated — re-paste next-auth.session-token from app.blackbox.ai

What it means

Error "Blackbox session is not authenticated — re-paste next-auth.session-token from app.blackbox.ai" thrown in diegosouzapw/OmniRoute.

Source

Thrown at open-sse/executors/blackbox-web.ts:626

              "If you have a paid plan, re-paste your session cookie from app.blackbox.ai.",
            type: "upstream_error",
            code: "BLACKBOX_SUBSCRIPTION_REQUIRED",
          },
        }),
        { status: 402, headers: { "Content-Type": "application/json" } }
      );
      return { response: errorResponse, url: BLACKBOX_CHAT_API, headers, transformedBody };
    }

    if (isAuthError) {
      log?.warn?.("BLACKBOX-WEB", "Blackbox returned auth error in response body");
      const errorResponse = new Response(
        JSON.stringify({
          error: {
            message:
              "Blackbox session is not authenticated — re-paste next-auth.session-token from app.blackbox.ai",
            type: "upstream_error",
            code: "BLACKBOX_AUTH_REQUIRED",
          },
        }),
        { status: 401, headers: { "Content-Type": "application/json" } }
      );
      return { response: errorResponse, url: BLACKBOX_CHAT_API, headers, transformedBody };
    }

    if (isRateLimit) {
      log?.warn?.("BLACKBOX-WEB", "Blackbox returned rate-limit error in response body");
      const errorResponse = new Response(
        JSON.stringify({
          error: {
            message: "Blackbox Web rate limited the session. Wait a moment and retry.",
            type: "upstream_error",
            code: "BLACKBOX_RATE_LIMIT",
          },
        }),
        { status: 429, headers: { "Content-Type": "application/json" } }

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at open-sse/executors/blackbox-web.ts:626 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of diegosouzapw/OmniRoute@a179ffed5b (2026-08-25). Data as JSON: /api/errors/90971ab388e55253. Report an issue: GitHub.