<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns one of the app's users.

Pass me as user_id to get your own record. Any user of the app can read their own record, by me or by ID. Reading another user's record needs editor access to the app, and row-level security on the User entity applies to it, so a user the rls read rule hides is reported as not found. Field-level rules on the User entity apply to every record, your own included.

Accounts Base44 added to the app on its own, such as workspace admins and support staff granted access, and the short-lived accounts a test run creates, are reported as not found unless the record is your own.

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

<Note>This endpoint accepts a personal API key belonging to a user of the app, or a workspace API key, which acts as the workspace owner. With a workspace API key, me is the workspace owner's record. Read-only keys work too.</Note>

Runs as your user in this app, so the app's access rules decide which records you can read or change.

get/api/apps/{app_id}/entities/User/{user_id}

Request

  • Base URL
    https://app.base44.com
  • Auth
    • HTTP bearer
    • or API key in header api_key
    • or HTTP bearer

Path parameters

user_idstring required

ID of the user, as id in the response of List app users, or me for your own record.

app_idstring required

ID of the app the user belongs to.

Response

The user.

idstring nullable

ID of the user.

emailstring nullable

Email the user signs in with.

full_namestring nullable

The user's name, or null if they haven't given one.

rolestring nullable

The user's role in the app. user and admin are built in, and an app can define its own.

collaborator_role'editor' nullable

editor when the user can also edit the app in Base44, otherwise null.

created_datestring nullable

When the user joined the app, as a UTC timestamp in ISO 8601 format.

updated_datestring nullable

When the user's record last changed, as a UTC timestamp in ISO 8601 format.

Example response

{
  "id": "6874b0c2e1a94d0031bb77de",
  "email": "jane@acme.com",
  "full_name": "Jane Cooper",
  "role": "user",
  "collaborator_role": "editor",
  "created_date": "2026-06-01T09:23:41.481000Z",
  "updated_date": "2026-06-04T14:07:02.115000Z"
}

Changes

    • info

      added the non-success response with the status

    • info

      the endpoint scheme security WorkspaceApiKeyAuth was added to the API

    • info

      the endpoint scheme security WorkspaceApiKeyBearerAuth was added to the API