Sign in

Get app user

<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, including a read-only key. Workspace API keys are not accepted.</Note>

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

Path parameters

user_idstring required

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

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.

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

Changed in 1 of the 33 revisions of this API.1