Transfer ownership to a workspace member

Changed on

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

Makes an owner, admin, editor, or member of the app's workspace the app's owner right away, with no invitation.

Unlike Start ownership transfer, the recipient doesn't have to accept. The app stays in its workspace, and only its owner changes. The new owner gets editor access, and the app's collaborators and published site stay as they are. The previous owner loses their direct access unless you set keep_sender_as_collaborator, though a workspace owner or admin keeps access through the workspace.

An app with a secret, or with a connected integration of its own, can't be transferred this way. Invite the new owner instead. An app with a pending ownership transfer, or one that's moving to another workspace, is rejected too.

You need to own the app, or be an owner or admin of its workspace with an Enterprise workspace or approved partner status.

This is limited to 30 requests a minute per workspace. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key. A read-only key is refused, and workspace API keys are not accepted.</Note>

post/api/apps/{app_id}/ownership/transfer/workspace-member

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/ownership/transfer/workspace-member
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app.

Request body

new_owner_user_idstring required

ID of the Base44 user who becomes the owner. They have to be an owner, admin, editor, or member of the app's workspace.

keep_sender_as_collaboratorboolean

Whether the app's current owner keeps editor access to the app after the transfer (true) or loses their direct access to it (false). An owner or admin of the workspace the app ends up in keeps access through that workspace either way. Defaults to false.

Example request

{
  "new_owner_user_id": "6706af53b9c1e2004a37d85f"
}

Response

The app, with its new owner.

app_idstring required

ID of the app.

app_namestring required

Name of the app.

app_typestring nullable

Type of the app, for example user_app or user_agent, or null when it isn't set.

new_owner_idstring required

ID of the Base44 user who owns the app now.

target_workspace_idstring nullable

ID of the workspace the app is in.

Example response

{
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "app_name": "Acme CRM",
  "app_type": "user_app",
  "new_owner_id": "6706af53b9c1e2004a37d85f",
  "target_workspace_id": "67f2c8e01a3b5d004e92d7a1"
}

Changes