Skip to main content
POST
Check ownership transfer

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Body

application/json

The ownership transfer invitation to check.

new_owner_email
string
required

Email address of the new owner. An invalid address comes back as a blocker.

Example:

"jane@acme.com"

destination
enum<string> | null

Either same_workspace, to invite an owner, admin, editor, or member of the app's workspace, or external_email, to invite anyone. Defaults to external_email.

Available options:
same_workspace,
external_email
Example:

"external_email"

Response

The result of the check.

Whether an ownership transfer invitation can be sent, and what would transfer with the app.

can_send
boolean
required

Whether the invitation can be sent (true) or a blocker stops it (false).

Example:

true

recipient_status
string
required

Summary of the result. Either can_send, recipient_must_sign_in_first when the recipient doesn't have a Base44 account yet but the invitation can still be sent, invalid_email, or blocked_policy for any other blocker.

Example:

"can_send"

blockers
OwnershipTransferPreflightIssue · object[]

Problems that stop the invitation from being sent. It's empty when can_send is true.

warnings
OwnershipTransferPreflightIssue · object[]

Things to know that don't stop the invitation.

transfer_package
OwnershipTransferPackageSummary · object | null

What would transfer with the app, or null when you can't manage ownership transfers for this app.