createClientFromRequest

createClientFromRequest(request): Base44Client

Creates a Base44 client from an HTTP request. This function is designed for use in Base44-hosted backend functions. For frontends and external backends, use createClient() instead. When used in a Base44-hosted backend function, createClientFromRequest() automatically extracts authentication tokens from the request headers that Base44 injects when forwarding requests. The returned client includes service role access using base44.asServiceRole, which bypasses entity access rules and field-level security. To learn more about the Base44 client, see createClient().

Parameters

request

Request

requis

The incoming HTTP request object containing Base44 authentication headers.

Returns

Base44Client The Base44 client instance. Provides access to all SDK modules for interacting with the app. A configured Base44 client instance with authentication from the incoming request.

Properties

agents

AgentsModule

requis

Agents module for managing AI agent conversations.

analytics

AnalyticsModule

requis

Analytics module for tracking custom events in your app.

appLogs

AppLogsModule

requis

App logs module for tracking app usage.

auth

AuthModule

requis

Auth module for user authentication and management.

connectors

UserConnectorsModule

requis

Connectors module for app-user OAuth flows.

entities

EntitiesModule

requis

Entities module for CRUD operations on your data models.

functions

FunctionsModule

requis

Functions module for invoking custom backend functions.

integrations

IntegrationsModule

requis

Integrations module for calling pre-built integration endpoints.

cleanup

() => void

requis

Cleanup function to disconnect WebSocket connections. Call when you’re done with the client.

asServiceRole

object

requis

Provides access to supported modules with elevated permissions.Service role authentication provides elevated permissions for backend operations. Unlike user authentication, which is scoped to a specific user’s permissions, service role authentication bypasses entity access rules and field-level security entirely, giving full read and write access to all of the app’s data.

Properties

agents

AgentsModule

requis

Agents module with elevated permissions.

appLogs

AppLogsModule

requis

App logs module with elevated permissions.

connectors

ConnectorsModule

requis

Connectors module for OAuth token retrieval.

entities

EntitiesModule

requis

Entities module with elevated permissions.

functions

FunctionsModule

requis

Functions module with elevated permissions.

integrations

IntegrationsModule

requis

Integrations module with elevated permissions.

cleanup

() => void

requis

Cleanup function to disconnect WebSocket connections.

Examples

import { createClientFromRequest } from 'npm:@base44/sdk';

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);
    const user = await base44.auth.me();

    if (!user) {
      return Response.json({ error: 'Unauthorized' }, { status: 401 });
    }

    // Access user's data
    const userOrders = await base44.entities.Orders.filter({ userId: user.id });
    return Response.json({ orders: userOrders });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});

import { createClientFromRequest } from 'npm:@base44/sdk';

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);

    // Read across all users, bypassing the Orders entity's access rules
    const recentOrders = await base44.asServiceRole.entities.Orders.list('-created_at', 50);

    return Response.json({ orders: recentOrders });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});

Get Started

SDK Reference

Parameters

Returns

Examples

​Parameters

​Returns

​Examples

Parameters

Returns

Examples