Skip to content

docs: rename Teams to Projects (+ new Projects page)#306

Open
beran-t wants to merge 2 commits into
mainfrom
cambridge-v1
Open

docs: rename Teams to Projects (+ new Projects page)#306
beran-t wants to merge 2 commits into
mainfrom
cambridge-v1

Conversation

@beran-t

@beran-t beran-t commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

What

Per the Teams → Projects rename, this:

  1. Adds a new concept page docs/projects.mdx (under Getting started, after API key) explaining what a project is and what it owns: API keys, sandboxes, templates, and billing/limits. Includes an <Info> note that projects were formerly called Teams and existing keys/slugs keep working.
  2. Renames the "Teams" concept to "Projects" in user-facing prose across:
    • billing.mdx, byoc.mdx, template/caching.mdx, template/base-image.mdx, template/tags.mdx, template/names.mdx (incl. the "Team-local naming" heading)
    • faq/public-templates.mdx (title + body)
    • migration/access-token-deprecation.mdx
    • sandbox/lifecycle-events-api.mdx, sandbox/lifecycle-events-webhooks.mdx (prose + comments)
    • Illustrative slug placeholders your-team-slug / team-slug/template-nameyour-project-slug / project-slug/template-name

Deliberately NOT changed (needs product confirmation)

I left literal API/env identifiers as-is, because the Slack ask was a rename of the concept, not a stated change to the API surface. Renaming these in docs would misdocument the actual product unless the API is also changing:

  • E2B_TEAM_ID env var (sandbox/environment-variables.mdx)
  • teamId / sandboxTeamId / sandbox_team_id fields in webhook/API response payloads
  • The underlying template slug values (the format placeholders are relabeled, but existing slug strings are unchanged and still work)

Question for review: are any of these API-level identifiers also being renamed? If so, I'll follow up. Also left untouched: incidental non-concept uses like "our support team" and "deploying for your team," plus the unrelated Microsoft Teams / Teamwork MCP entries.

Renames the "Teams" concept to "Projects" across user-facing prose and
adds a new docs/projects.mdx concept page.

- New page: docs/projects.mdx (Getting started nav) explaining what a
  project owns (API keys, sandboxes, templates, billing) plus a note
  that Teams was the former name.
- Rename conceptual prose and illustrative slug placeholders
  (your-team-slug -> your-project-slug) in billing, byoc, template
  names/tags/caching/base-image, public-templates FAQ, access-token
  migration, and sandbox lifecycle pages.

Left literal API/env identifiers unchanged (E2B_TEAM_ID, teamId,
sandboxTeamId, sandbox_team_id) since those are part of the actual
API surface and were not stated to change. See PR description.
@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
e2b 🟢 Ready View Preview Jul 20, 2026, 9:14 PM

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
e2b 🟡 Building Jul 20, 2026, 9:10 PM

Comment thread docs/projects.mdx
icon: "folder"
---

A **project** is the workspace under your E2B account that owns everything you build: API keys, sandboxes, templates, and billing. Every sandbox you create runs inside a project, and every API key is scoped to exactly one project, so the key you use determines which project's resources and limits apply.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@beran-t what about

A project groups the resources you build with under your E2B account — API keys, sandboxes, templates, and billing. Every sandbox runs inside a project, and every API key is scoped to exactly one project, so the key you use determines which project's resources and limits apply.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants