session_required

HTTP status: 401 · Code: session_required

The operation needs a signed in user’s access token in Authorization: Bearer.

Why it happens

The operation needs a signed in user, and the request had no access token in Authorization: Bearer.

How to fix

Sign the user in first. With a client SDK, check that the session is stored: in Next.js it lives in cookies, so call Orvano from a server component, server action, or route handler that reads them.

Catch it in your code

Every SDK throws one error type for a failed call. Match on its code, which is always session_required for this error, never on the message.

JavaScript and Next.js

import { ErrorCode, OrvanoError } from '@orvano/js'

try {
  // your Orvano call
} catch (error) {
  if (error instanceof OrvanoError && error.code === ErrorCode.sessionRequired) {
    // handle session_required
  } else {
    throw error
  }
}

Dart and Flutter

import 'package:orvano_flutter/orvano_flutter.dart'; // or orvano_dart on a server

try {
  // your Orvano call
} on OrvanoException catch (error) {
  if (error.code != ErrorCode.sessionRequired) rethrow;
  // handle session_required
}

.NET

using Orvano;

try
{
    // your Orvano call
}
catch (OrvanoException error) when (error.Code == ErrorCode.SessionRequired)
{
    // handle session_required
}

The error also carries the HTTP status (401), a message, and a request ID. Quote the request ID when you report a problem: the server logs it with the failure. See Errors for how errors work in every SDK, or every error code.