On this page

Transfer Ownership

Ownership transfer allows the current Owner of a project to pass full control to another team member. This is useful when the person responsible for the project changes or when you need to reorganize how your projects are managed.

Requirements

Before transferring ownership, make sure that:

  • You are the current Owner of the project. Only the Owner can initiate a transfer.
  • The member who will receive ownership is already part of the project. You cannot transfer to someone who is not a member.
  • The target member has enough quota in their current tier to receive the project.

What happens during transfer

When ownership is transferred:

  • The chosen member becomes the new Owner of the project with full control.
  • The previous Owner is automatically downgraded to the Admin role, keeping broad access to the project.
  • All project settings are preserved (services, deploys, domains, environment variables, etc.).
  • Billing and quota responsibility move to the new Owner’s resolved tier.
  • The project tier stored by Guara Cloud is updated to the new Owner’s resolved tier.

How to transfer

  1. Go to project members — open the project in the dashboard and click Members in the sidebar menu.

  2. Open the member menu — find the member who should receive the project and open the row action menu.

  3. Preview the transfer — click Transfer ownership. Guara Cloud checks the target member’s tier limits before allowing confirmation.

  4. Confirm the transfer — review the role and quota impact, type the target email or project name, and click Transfer ownership.

API behavior

The dashboard first calls POST /projects/:projectId/transfer-ownership/preview with:

{ "target_user_id": "..." }

The preview returns the target member, target tier, role outcome, and quota_impact. It does not mutate the project.

The final transfer calls POST /projects/:projectId/transfer-ownership with the same body. The API repeats the quota check inside the ownership transaction before writing memberships, project ownership, audit logs, notifications, or outbox messages.

If the target member would exceed quota, the transfer fails with OWNERSHIP_TRANSFER_TARGET_OVER_QUOTA and HTTP 402. The response includes blocking reasons for resources such as projects, services per project, cron workers, storage, account CPU, and account memory.

Frequently asked questions

Can I recover ownership after the transfer?

Not directly. The new Owner will need to perform a new transfer back to you. If that is not possible, contact support.

Does the transfer affect my services?

No. All services continue running normally. No deploys are interrupted or restarted.

Can I transfer to a Viewer?

Yes, as long as the person is a project member. The member’s current role does not matter — upon receiving ownership, they automatically become the Owner.