Change your team name and URL

Your team has two separate pieces of identity, and they change independently.

Display name is what people read. It appears in the dashboard, on invitations and in the emails we send you. It can be anything up to 100 characters, spaces and accents included: Acme Studio, Équipe Volt.
Team URL is a short lowercase identifier. It is unique across deploybase, it can be used in place of your team ID in API paths today, and it will be the address of your team’s sign-in link once single sign-on is available. SSO is being built; there is no date for it yet.

Where to change them

Go to Settings → General. The Display name and Team URL fields sit together, and one Save writes both.

Only the team Owner can edit them. Admins, Members and Viewers see the current values but cannot change them.

Why your team already has a name

deploybase picks both for you when the team is created, so nothing is ever blocked on naming a team you did not ask for. The guess comes from the Owner’s name: someone called Sam gets the display name Sam's team and the URL sam-team. Where no usable name is available, the URL is a pair of random words instead.

Until you make a choice, the field carries the note “We picked this for you. Keep it or change it.” Press Keep this URL to confirm the suggestion, or type a new one. Either way the note goes away.

Rules for the team URL

A team URL:

is 3 to 40 characters long
uses lowercase letters, digits and hyphens only
cannot start or end with a hyphen, and cannot use two hyphens in a row
cannot be only digits
cannot be a reserved word

Reserved words are the ones we cannot let a team take without breaking something or misleading somebody:

words we use for pages and hostnames, such as settings, docs, www and previews
standard mailbox names, such as support, info and postmaster
words that could pass a team off as deploybase staff, such as official, staff and noreply
anything containing deploybase or dbk, anywhere in the URL

URL	Result
`acme-studio`	Accepted
`northwind-2`	Accepted
`blue-heron-labs`	Accepted
`Acme Studio`	Rejected: uppercase and a space
`2026`	Rejected: only digits
`deploybase-acme`	Rejected: contains our brand name

The field checks as you type, so you see the answer before you save.

What happens when you change the URL

Changing the URL leaves a redirect behind. The old URL keeps resolving to your team for as long as nobody else claims it, so a link that was already shared does not break the moment you press Save.

For 30 days after the rename, only your team can take the old URL back. That window is the undo: set the URL back to the old value inside it and you have your original address again. After 30 days the old URL is free, and another team may claim it. Once that happens the redirect stops, and the old URL points at their team, not yours.

So treat 30 days as the deadline for updating anything you have shared: your SSO sign-in link when SSO arrives, bookmarks, internal wiki pages, scripts that call the API by team URL.

Renaming a team changes nothing about how your sites are served. Your sites.deploybase.eu production URLs, your custom domains and your preview URLs are all derived from the project, not the team, and they are untouched by a team rename.

If the URL you want is taken

The field offers three free alternatives under it: your first choice with a number appended, then with a short random tail. Press one to fill it in.

There is no way to reclaim a URL another team holds, and no waiting list. A URL held by a team that renamed away from it becomes free 30 days later, but nothing tells you when.

Using the team URL in the API

Endpoints under /api/v1/teams/{team} accept either form in that path segment: the team URL, or the team ID.

curl https://api.deploybase.eu/api/v1/teams/acme-studio/profile \
  -H "Authorization: Bearer $DEPLOYBASE_API_KEY"

curl https://api.deploybase.eu/api/v1/teams/$DEPLOYBASE_TEAM_ID/profile \
  -H "Authorization: Bearer $DEPLOYBASE_API_KEY"

The team ID never changes, so a script that has to survive a rename with no redirect window should use the ID.

Troubleshooting

Why does it say the URL is reserved? The word is one we use ourselves, a standard mailbox name, or one that could make your team look like deploybase support. Add a word of your own to it: support-acme is fine, support is not. Anything containing deploybase or dbk is rejected wherever it appears.

Why can’t I use uppercase? The URL has to be valid as part of a hostname, and hostnames have no case. Acme and acme would be the same address, so only the lowercase form is accepted. Put the capitals in the display name instead, which keeps them exactly as you type them.

I renamed by mistake. Can I get the old URL back? Yes, within 30 days. Go back to Settings → General and type the old URL. It is held for your team alone for that period, so it will be accepted. After 30 days it may already belong to someone else, and then it cannot be recovered.

Someone else has my old URL. Then the 30-day hold expired and they claimed it. The redirect has stopped and there is nothing to undo: their team now answers at that address. Update any link still pointing there, and use your team ID in scripts that must not break again.