Entaprenua
Docs

Ownership Transfer

Transfer store ownership to another team member. This is useful when handing off a store to a client, changing business ownership, or reassigning responsibilities.

Initiating a Transfer

  1. Go to Admin → Settings → Team
  2. Find the member you want to transfer ownership to
  3. They must already be a member (Admin role or higher)
  4. Click Transfer Ownership (requires Owner role)
  5. Confirm the transfer

The transfer creates a pending request. The recipient must accept it before ownership changes.

Transfer Status

Status Description
Pending Transfer initiated, awaiting recipient acceptance
Accepted Recipient accepted — ownership transferred
Revoked Initiator cancelled the transfer
Expired Recipient didn't accept within the time limit

Transfers expire after a set period if not accepted.

What Happens After Transfer

When ownership is transferred:

  • The recipient becomes the new Owner
  • The previous owner is demoted to Admin
  • All Owner capabilities (delete store, manage API keys, manage roles) transfer to the new Owner

Only the current Owner can initiate a transfer.

Cancelling a Transfer

If you change your mind:

  1. Go to Admin → Settings → Team
  2. Find the pending transfer
  3. Click Cancel Transfer

Only the Owner who initiated the transfer can cancel it.

Accepting a Transfer

If you receive an ownership transfer:

  1. You'll be notified of the pending transfer
  2. Review the store details
  3. Click Accept to take ownership
  4. Or decline to remain in your current role

API

GET    /api/v1/{storePublicId}/transfer              — List pending transfers
POST   /api/v1/{storePublicId}/transfer              — Initiate transfer (Owner)
DELETE /api/v1/{storePublicId}/transfer/{transferId} — Cancel transfer (Owner)
POST   /api/v1/stores/transfer/accept                — Accept transfer (global endpoint)