Merge branch 'railwayapp:main' into main

Author: AzadZedan

contentlayer.config.ts

@@ -2,6 +2,7 @@ import { defineDocumentType, makeSource } from "contentlayer/source-files";
 import remarkAutoLinkHeadings from "remark-autolink-headings";
 import remarkGfm from "remark-gfm";
 import remarkSlug from "remark-slug";
+import { execSync } from "child_process";
 
 const Page = defineDocumentType(() => ({
   name: "Page",
@@ -24,6 +25,20 @@ const Page = defineDocumentType(() => ({
       type: "string",
       resolve: doc => `/${doc._raw.flattenedPath}`,
     },
+    lastModified: {
+      type: "date",
+      resolve: doc => {
+        const filePath = `src/docs/${doc._raw.flattenedPath}.md`;
+        try {
+          const result = execSync(`git log -1 --format=%cI -- "${filePath}"`, {
+            encoding: "utf-8",
+          }).trim();
+          return result || new Date().toISOString();
+        } catch {
+          return new Date().toISOString();
+        }
+      },
+    },
   },
 }));
 

public/static/faq.json

@@ -16,8 +16,8 @@
       "How do I verify my account?",
       "Why do I need to verify?"
     ],
-    "answer": "Your account requires additional information to use the Trial plan. Make sure to link a GitHub account and a Credit Card to pass the verification check.",
-    "link": ""
+    "answer": "Without verification, your Trial account will have some network restrictions. Link a GitHub account or Credit Card to verify your account and unlock full network access.",
+    "link": "https://docs.railway.com/reference/pricing/free-trial#full-vs-limited-trial"
   },
   "region": {
     "category": "general",

redirects.js

@@ -99,6 +99,11 @@ const redirects = [
     destination: "/reference/errors",
     permanent: true,
   },
+  {
+    source: "/reference/teams",
+    destination: "/reference/workspaces",
+    permanent: true,
+  },
 ];
 
 const hashRedirects = [

src/docs/guides/cli.md

@@ -96,23 +96,23 @@ In situations where user input or interaction isn't possible, such as in CI/CD p
 
 A [Project Token](/guides/public-api#project-token) is set via the `RAILWAY_TOKEN` environment variable.
 
-An [Account](/guides/public-api#personal-token) or [Team](/guides/public-api#team-token) Token is set via the `RAILWAY_API_TOKEN` environment variable.
+An [Account](/guides/public-api#using-an-account-token) or [Workspace](/guides/public-api#using-a-workspace-token) Token is set via the `RAILWAY_API_TOKEN` environment variable.
 
-**Note:** You can only use one type of token at a time. If both are set, the `RAILWAY_TOKEN` variable will take precedence.
+**Note:** If both environment variables are set, `RAILWAY_TOKEN` takes precedence. This allows you to use a project token for specific deployments while having a broader account token configured.
 
 #### Project Tokens
 
-You can use [Project Tokens](/guides/public-api#project-token) to authenticate project-level actions.
+You can use [Project Tokens](/guides/public-api#project-token) to authenticate project-level actions within a single environment.
 
-Project Tokens allow the CLI to access all the project-level actions in the environment set when the token was created.
+Project tokens are scoped to a specific environment within a project. If you need to perform actions across multiple environments, use an account or workspace token instead.
 
-Some actions you can perform with a project token include -
+Some actions you can perform with a project token include:
 
 - Deploying code - `railway up`
 - Redeploying a deployment - `railway redeploy`
 - Viewing build and deployment logs - `railway logs`
 
-Some actions you **cannot** perform with a project token include -
+Some actions you **cannot** perform with a project token include:
 
 - Creating a new project - `railway init`
 - Printing information about the user - `railway whoami`
@@ -126,26 +126,32 @@ RAILWAY_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX railway up
 
 #### Account Tokens
 
-Account Tokens come in two types - [Personal Account Tokens](/reference/public-api#personal-token) and [Team Tokens](/reference/public-api#team-token).
+You can use [Account Tokens](/guides/public-api#using-an-account-token) to authenticate all CLI actions across all your resources and workspaces. This is the broadest scope—all CLI commands are available with an account token.
 
-You can use Account Tokens to authenticate all CLI actions across all workspaces.
+Some actions you can **only** perform with an account token include:
 
-However, you can only use Team tokens to authenticate actions on projects within the workspace the token was scoped to when it was created.
+- Printing information about the user - `railway whoami`
+- Linking to projects in any of your workspaces - `railway link`
 
-Some actions you can perform with a personal account token include -
+Use the token by setting the `RAILWAY_API_TOKEN` environment variable and then running `railway <command>`.
 
-- Creating a new project - `railway init`
-- Printing information about the user - `railway whoami`
+```bash
+RAILWAY_API_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX railway whoami
+```
+
+#### Workspace Tokens
+
+You can use [Workspace Tokens](/guides/public-api#using-a-workspace-token) to authenticate CLI actions on projects within a specific workspace. Use this when you want to share a token with teammates without giving access to your other workspaces.
 
-Some actions you **cannot** perform with [Team Token](/reference/public-api#team-token) include -
+Some actions you **cannot** perform with a workspace token include:
 
 - Printing information about the user - `railway whoami`
-- Linking to another workspace - `railway link`
+- Linking to projects outside the token's workspace - `railway link` (you can still link to other projects within the workspace)
 
 Use the token by setting the `RAILWAY_API_TOKEN` environment variable and then running `railway <command>`.
 
 ```bash
-RAILWAY_API_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX railway whoami
+RAILWAY_API_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX railway up
 ```
 
 ## Common Examples of CLI Usage
@@ -156,17 +162,17 @@ Below are some of the most commonly used CLI commands. Find a complete list of C
 
 To associate a project and environment with your current directory:
 
-<Image src="https://res.cloudinary.com/railway/image/upload/v1631917786/docs/railway-link_juslvt.png"
-alt="Screenshot of Railway"
+<Image src="https://res.cloudinary.com/railway/image/upload/v1770156020/docs/railway-link-2026_dwz6mi.png"
+alt="Screenshot of railway link command"
 layout="intrinsic"
-width={389} height={116} quality={80} />
+width={824} height={294} quality={80} />
 
 ```bash
 # Link to a project
 railway link
 ```
 
-This prompts you to select a team, project, and environment to associate with
+This prompts you to select a workspace, project, and environment to associate with
 your current directory. Any future commands will be run against this project and environment.
 
 ### Link to a Service
@@ -189,7 +195,7 @@ Create a new project directly from the command line.
 railway init
 ```
 
-This prompts you to name your project and select a team to create the project in.
+This prompts you to name your project and select a workspace to create the project in.
 
 ### Local Development
 

src/docs/guides/create.md

@@ -35,7 +35,7 @@ Note that your template will not be available on the template marketplace, nor w
 
 It's now possible to specify a private GitHub repo when creating a template.
 
-This feature is intended for use among [Teams](/reference/teams) and [Organizations](/reference/teams). Users supporting a subscriber base may also find this feature helpful to distribute closed-source code.
+This feature is intended for use among [Teams](/reference/workspaces) and [Organizations](/reference/workspaces). Users supporting a subscriber base may also find this feature helpful to distribute closed-source code.
 
 To deploy a template that includes a private repo, look for the `GitHub` panel in the `Account Integrations` section of [General Settings](https://railway.com/account). Then select the `Edit Scope` option to grant Railway access to the desired private repos.
 

src/docs/guides/environments.md

@@ -51,7 +51,7 @@ When enabled, a temporary environment is spun up to support the Pull Request dep
 
 #### How Come my GitHub PR Won't Deploy?
 
-Railway will not deploy a PR branch from a user who is not in your team or invited to your project without their associated GitHub account.
+Railway will not deploy a PR branch from a user who is not in your workspace or invited to your project without their associated GitHub account.
 
 #### Domains in PR Environments
 

src/docs/guides/optimize-usage.md

@@ -13,9 +13,9 @@ Visit the <a href="https://railway.com/workspace/usage" target="_blank">Workspac
 
 <Image src="https://res.cloudinary.com/railway/image/upload/v1743193518/docs/usage-limits_pqlot9.png" alt="Usage Limits Modal" layout="responsive" width={1200} height={1075} />
 
-#### Setting Limits for Teams
+#### Setting Limits for Workspaces
 
-If you want to set a usage limit for your team, use the account switcher in the top left corner of your dashboard to access the team's usage page.
+If you want to set a usage limit for a different workspace that you are an admin of, use the account switcher in the top left corner of your dashboard to access that workspace's usage page.
 
 ### Custom Email Alert
 

src/docs/guides/projects.md

@@ -49,11 +49,11 @@ Each project generates a project invite link. To invite someone via a link:
 
 ## Transferring Projects
 
-Depending on your plan, you can transfer Projects to other users or Teams.
+Projects can be transferred between workspaces or to other users. Both the source and destination must have an active [Hobby or Pro plan](/reference/pricing#plans) subscription.
 
-#### Hobby User to Hobby User
+#### Transferring to Another User
 
-To transfer a project from one Hobby User to another Hobby User, you must first [add the user as a member](#inviting-members) in the project.
+To transfer a project to another user, you must first [add the user as a member](#inviting-members) of the project.
 
 You can then transfer the project to the new member by selecting the three dots next to the user and choosing `Transfer Ownership`.
 
@@ -62,15 +62,15 @@ alt="Screenshot of Project Transfer Menu"
 layout="intrinsic"
 width={411} height={253} quality={80} />
 
-The transferee receives an email requesting to transfer the project.
+The recipient receives an email to confirm the transfer. They have 24 hours to accept.
 
-#### Hobby User to Team || Team to Team
+#### Transferring Between Workspaces
 
-You can transfer a Project in your Hobby workspace to a Team (or between Teams) in which you are an Admin. Inside your project, visit the `Settings` page and click the `Transfer Project` button to view the project transfer modal.
+You can transfer a project to another workspace that you're a member of. Inside your project, visit the `Settings` page and click the `Transfer Project` button to view the project transfer modal.
 
 <Image src="https://res.cloudinary.com/railway/image/upload/v1692378671/project-transfer_iukfwb.png" alt="Project Transfer" layout="responsive" height={968} width={1240} />
 
-Note: If you do not see the Transfer Project section in your Project Settings, you may not be an Admin of the Team to which you wish to transfer the Project. See the [reference page for Teams](/reference/teams#inviting-members) for more information on team member permissions.
+Note: You must be an Admin of the project to initiate a transfer. The destination workspace must have an active Hobby or Pro subscription. See the [Workspaces reference](/reference/workspaces#inviting-members) for more information on workspace roles.
 
 ## Viewing Recent Activity
 

src/docs/guides/public-api.md

@@ -30,21 +30,28 @@ https://backboard.railway.com/graphql/v2
 
 ### Creating a Token
 
-To use the API, you will need an API token. There are three types of tokens you can create.
+To use the API, you will need an API token. There are three types of tokens you can create in the Railway dashboard. If you're building an application that authenticates users, you can also use OAuth.
 
-#### Team Tokens and Account Tokens
+#### Choosing a Token Type
 
-You can create an API token from the [tokens page](https://railway.com/account/tokens) in your account settings.
+| Token Type | Scope | Best For |
+|------------|-------|----------|
+| Account token | All your resources and workspaces | Personal scripts, local development |
+| Workspace token | Single workspace | Team CI/CD, shared automation |
+| Project token | Single environment in a project | Deployments, service-specific automation |
+| OAuth | User-granted permissions | Third-party apps acting on behalf of users |
 
-<Image src="https://res.cloudinary.com/railway/image/upload/v1667386744/docs/new-token-form_rhrbw8.png"
+#### Account Tokens and Workspace Tokens
+
+You can create a workspace or account token from the [tokens page](https://railway.com/account/tokens) in your account settings.
+
+<Image src="https://res.cloudinary.com/railway/image/upload/v1770147536/docs/new_token_2026_v4yrmw.png"
 alt="New token form"
 layout="responsive"
-width={1618 } height={378} quality={80} />
+width={1674} height={374} quality={80} />
 
-- **Team token** - Select a team in the `Team` dropdown to create a token tied to a team. A team token has access to all the team's resources, and cannot be used to access your personal resources on Railway. Feel free to share this token with your teammates.
-- **Account token** - If you do not select a team, the token will be tied to your Railway account and will have access to all your resources including the teams you are a part of. Do not share this token with anyone else.
-
-_Note that Teams are a Pro feature._
+- **Account token**: If you select "No workspace", the token will be tied to your Railway account. This is the broadest scope. The token can perform any API action you're authorized to do across all your resources and workspaces. Do not share this token with anyone else.
+- **Workspace token**: Select a specific workspace in the dropdown to create a token scoped to that workspace. A workspace token has access to all the workspace's resources, and cannot be used to access your personal resources or other workspaces on Railway. You can share this token with your teammates.
 
 #### Project Token
 
@@ -72,21 +79,21 @@ curl --request POST \
   --data '{"query":"query { me { name email } }"}'
 ```
 
-**Note:** This query **cannot** be used with a team or project token because the data returned is scoped to your personal account.
+**Note:** This query **cannot** be used with a workspace or project token because the data returned is scoped to your personal account.
 
-#### Using a Team Token
+#### Using a Workspace Token
 
-If you have a team token, you can use it to authenticate requests to a specific team. The query below should return the team name and ID:
+If you have a workspace token, you can use it to authenticate requests scoped to that workspace. The query below should return the workspace name and ID:
 
 ```bash
 curl --request POST \
   --url https://backboard.railway.com/graphql/v2 \
-  --header 'Team-Access-Token: <TEAM_TOKEN_GOES_HERE>' \
+  --header 'Authorization: Bearer <WORKSPACE_TOKEN_GOES_HERE>' \
   --header 'Content-Type: application/json' \
-  --data '{"query":"query { team(id: \"<TEAM_ID_GOES_HERE>\") { name id } }"}'
+  --data '{"query":"query { workspace(workspaceId: \"<WORKSPACE_ID_GOES_HERE>\") { name id } }"}'
 ```
 
-**Note:** This query **can** also be used with an account token as long as you are a member of the team.
+**Note:** This query **can** also be used with an account token as long as you are a member of the workspace.
 
 #### Using a Project Token
 
@@ -100,6 +107,8 @@ curl --request POST \
   --data '{"query":"query { projectToken { projectId environmentId } }"}'
 ```
 
+**Note:** Project tokens use the `Project-Access-Token` header, not the `Authorization: Bearer` header used by account, workspace, and OAuth tokens.
+
 ## Viewing the Schema
 
 Use popular tools like [Postman](https://www.postman.com/) or [Insomnia](https://insomnia.rest/) to connect to the API and query the schema. Simply set up your connection with the endpoint and Authorization token, and fetch the schema.
@@ -116,12 +125,18 @@ Alternatively, you can use our [GraphiQL playground](https://railway.com/graphiq
 
 <Image src="https://res.cloudinary.com/railway/image/upload/v1694611003/rw-graphiql_zs2l28.png" alt="GraphiQL Playground" layout="responsive" width={6568} height={3886} quality={80} />
 
-Make sure to set an Authorization header with an [auth token](/reference/public-api#authentication). Click the "Headers" tab at the bottom of the GraphiQL page and enter this json, using your own token:
+Make sure to set a header with your [authorization token](/reference/public-api#authentication). Click the "Headers" tab at the bottom of the GraphiQL page and enter this json, using your own token based on your use case:
 
+For an account or workspace token:
 ```json
 { "Authorization": "Bearer <API_TOKEN_GOES_HERE>" }
 ```
 
+For a project token:
+```json
+{ "Project-Access-Token": "<PROJECT_TOKEN_GOES_HERE>" }
+```
+
 ## Tips and Tricks
 
 ### Resource IDs

src/docs/guides/storage-buckets.md

@@ -281,7 +281,7 @@ You can use up to **50 GB-month** during the trial. Bucket usage counts against
 
 ### Limited Trial
 
-Buckets are not available in the [Limited Trial](/reference/pricing/free-trial#full-vs-limited-trial).
+Buckets are available in the [Limited Trial](/reference/pricing/free-trial#full-vs-limited-trial), but services accessing them will have some [network restrictions](/reference/pricing/free-trial#full-vs-limited-trial).
 
 ### Hobby