Transfer project ownership
Transfer ownership of a project to another person or a client, or to a new account of your own. Projects belong to organizations, not to user accounts, so you either move the project to the recipient's organization or hand over your whole organization.
Prerequisites
Before you start, check that you meet the following requirements:
- To move the project, you're an Owner of the organization that the project belongs to. For the other checks a transfer runs, see Project transfer requirements.
- To hand over the organization, you're an Owner of it.
- To hand over the organization with the Management API, you have an access token. For a scoped token, under Resource access, select Organization, choose the organization, and grant Organization Members with Read-write access and Organization Settings with Read-write access.
- To make the recipient an Owner with the Management API, your organization is on the Team Plan or Enterprise Plan. On other plans, use the Dashboard for that step.
Move the project to their organization
To move the project to the recipient's organization and then leave that organization, follow these steps:
-
Ask the recipient to create an organization and invite you with a role for the whole organization. The Developer role is enough. On the Team Plan or Enterprise Plan, the recipient can also send the invitation with the create organization invitations endpoint.
-
Accept the invitation from the invitation email. The Management API has no endpoint for accepting an invitation.
-
Transfer the project to their organization, with the Supabase Dashboard or the Management API steps in Transfer a project.
-
Leave their organization.
Leaving an organization permanently deletes the content you saved in its projects, such as SQL snippets, including shared ones, custom reports, and Log Explorer queries. Copy anything that you or the recipient need before you leave.
In their organization's team settings, click Leave team. The recipient can also remove you, from the same page or with the remove organization members endpoint.
Hand over the whole organization
To hand over the organization with every project in it, make the recipient an Owner, have them replace your payment method, and leave.
You can't add an Owner from Supabase to an organization managed through the Vercel Marketplace. Give the person the owner role on your Vercel team instead.
To hand over the organization in the Supabase Dashboard, follow these steps:
-
In the organization's team settings, invite the recipient as an Owner, or promote a member to Owner.
-
After the recipient accepts, ask them to add their payment method in the organization's billing settings and to select Use this card. Then delete your card. On a paid plan, you can't delete the card that's active. A payment method that stays with the organization can still be charged after you leave.
-
Leave the organization.
Leaving an organization permanently deletes the content you saved in its projects, such as SQL snippets, including shared ones, custom reports, and Log Explorer queries. Copy anything that you or the recipient need before you leave.
In the organization's team settings, click Leave team.
To hand over the organization with the Management API, follow these steps:
-
Set the token, the organization's slug, and the recipient's email address. Replace
YOUR_ACCESS_TOKEN,YOUR_ORG_SLUG, andYOUR_RECIPIENT_EMAILwith your values:export SUPABASE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"export ORG_SLUG="YOUR_ORG_SLUG"export RECIPIENT_EMAIL="YOUR_RECIPIENT_EMAIL" -
Make the recipient an Owner. Both of the following requests need the Team Plan or Enterprise Plan. On other plans, use the Dashboard for this step.
If the recipient isn't a member of the organization, invite them with the create organization invitations endpoint:
curl -X POST "https://api.supabase.com/v2/organizations/$ORG_SLUG/members/invitations" \-H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \-H "Content-Type: application/json" \-d @- <<EOF{"data": [{"type": "organization_invitation","attributes": { "email": "$RECIPIENT_EMAIL", "role": "owner" }}]}EOFIf the recipient is already a member, find their
idwith the list organization members endpoint. Filter by their email address, because the endpoint returns one page of members at a time:curl -G "https://api.supabase.com/v2/organizations/$ORG_SLUG/members" \--data-urlencode "filter[primary_email]=$RECIPIENT_EMAIL" \-H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"Copy the
idfrom the response, and replaceYOUR_RECIPIENT_MEMBER_IDwith it. Then change their role with the assign organization member role endpoint:export MEMBER_ID="YOUR_RECIPIENT_MEMBER_ID"curl -X PATCH "https://api.supabase.com/v2/organizations/$ORG_SLUG/members/$MEMBER_ID/roles" \-H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \-H "Content-Type: application/json" \-d @- <<EOF{"data": {"type": "organization_member_role","attributes": { "role": "owner" }}}EOF -
After the recipient is an Owner, ask them to add their payment method in the organization's billing settings and to select Use this card. Then delete your card. The Management API has no endpoint for payment methods. A payment method that stays with the organization can still be charged after you leave.
-
Remove yourself with the remove organization members endpoint. The request fails while you're the only Owner.
Find your own
idin the list of members. ReplaceYOUR_EMAILwith the email address of your account:curl -G "https://api.supabase.com/v2/organizations/$ORG_SLUG/members" \--data-urlencode "filter[primary_email]=YOUR_EMAIL" \-H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"Leaving an organization permanently deletes the content you saved in its projects, such as SQL snippets, including shared ones, custom reports, and Log Explorer queries. Copy anything that you or the recipient need before you leave.
Copy the
idfrom the response, and replaceYOUR_MEMBER_IDwith it. Then remove yourself:export MY_MEMBER_ID="YOUR_MEMBER_ID"curl -X DELETE "https://api.supabase.com/v2/organizations/$ORG_SLUG/members/$MY_MEMBER_ID" \-H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"
If the organization's billing email is your address, it changes to a remaining Owner's address when you leave, unless the organization is billed through a partner, such as Vercel or the AWS Marketplace. A billing email set to any other address stays the same.
Next steps
After the handover, use these pages:
- Changes after a project transfer: if you moved the project, check which organization pays for it, and who keeps access to it.
- Troubleshoot a project transfer: if a message blocks the transfer, find its cause and its fix.
Related resources
To read more about ownership and roles, see these pages:
- Transferring ownership of an organization: the rule that every organization keeps at least one Owner.
- Recover access to the Owner account: what to do when you can't sign in to the Owner account.