邀請成員

要加一位團隊成員，只需要一個連結。管理員建立邀請，你把網址傳給對方，對方在已登入的狀態下開啟並選擇 接受邀請，就立刻加入組織。

開始之前

條件	為什麼
你是目前作用中組織的管理員	邀請是僅限管理員的動作
目前作用中的工作區不是你的個人工作區	個人工作區不能有成員

如果側邊欄頂端的切換器顯示 個人，請先建立一個組織 — 請見切換組織。

建立邀請

1. 在側邊欄開啟 團隊。
2. 選擇 邀請。
3. 輸入同事的電子郵件地址。
4. 挑一個角色：成員 — 可部署與使用 API 或 管理員 — 完整存取權。
5. 選擇 建立邀請。

Superheat 會回傳一個連結：

https://console.superheat.cloud/join?token=<token>

在關掉對話框之前先複製起來。權杖只會顯示一次，之後無法再取得。弄丟了就撤銷這個邀請，重新建一個。

仍然要把連結當成憑證

邀請會綁定你輸入的電子郵件地址：只有目前以該地址登入的人才能接受 —— 看的是這次登入的電子郵件，而不是帳號建立時記下的那個。其他人開啟連結只會被告知邀請不存在，或寄給了別的地址，即使權杖完全有效。

這是實際的限制，不是形式 — 但權杖仍然存在於網址中，會透過貼上的連結與 Referer 標頭外洩。請直接傳給本人，不要丟進共用頻道；一旦流向不該去的地方，立刻撤銷。

手機號碼帳號無法接受邀請

邀請只能以電子郵件地址建立，邀請對話框裡也寫著：「邀請僅支援電子郵件；以手機號碼登入的成員暫時無法被邀請。」只用手機號碼登入的帳號沒有電子郵件，因此無法接受任何邀請：開啟連結只會看到「此邀請不存在，或寄送的電子郵件地址與你目前登入的不同。」，儀表板上也不會出現邀請橫幅。被邀請的人需要在登入頁選擇電子郵件，以被邀請的地址登入。

你的同事怎麼接受

有兩條路徑，兩者最後得到的成員資格完全一樣。

路徑	他們要做的事
連結	登入，開啟 /join?token=…，選擇 接受邀請
在主控台裡	用被邀請的電子郵件地址登入，然後在儀表板上那則寫著「你已受邀以 … 身分加入 …」的橫幅上選擇 接受

兩條路徑都需要以被邀請的地址登入；橫幅只是便利入口，不是第二種進入方式。

開啟連結後，在任何事發生之前，頁面會先說明他們要接受的是什麼：標題 加入 {org}、是誰邀請的、以哪個角色加入，以及邀請何時到期。管理員邀請還會多一行，說明管理員能做什麼。接受邀請 就會加入；暫不加入 則讓邀請維持未使用。

透過連結接受之後，頁面會顯示 你已加入 {org}，並詢問要不要現在切換過去 —— 切換到 {org}，或 留在目前的工作區。工作區不會在沒問過的情況下切換。如果他們還沒有帳號，要先在登入頁選擇電子郵件，以被邀請的地址透過免密碼登入建立一個 — 請見建立帳號。

如果出了狀況，頁面會顯示下列訊息：

訊息	發生什麼事
此邀請已被使用。	每個邀請只能用一次。再建一個。
此邀請已過期。請管理員重新傳送。	邀請自建立起 7 天內有效。
此邀請不存在，或寄送的電子郵件地址與你目前登入的不同。	邀請已被撤銷（或者因為寄出它的管理員被移除、被改成成員而一併作廢）、權杖有誤或被截斷 — 或者你登入的電子郵件與被邀請的地址不同，或者你登入的是沒有電子郵件的手機號碼帳號。請登出後以被邀請的電子郵件地址重新登入。
此邀請已失效 — 寄件者已不再是管理員。請向目前的管理員索取新的邀請。	建立它的管理員已不再是這個組織的管理員，邀請也就不再有效。
缺少邀請權杖	開啟網址時少了 ?token= 那一段。請複製完整連結。

待處理的邀請

團隊 頁面會列出每一個尚未被接受、也尚未過期的邀請，附上角色與到期日。管理員看得到這份清單；成員看不到。

• 撤銷 會刪掉該邀請。連結立刻失效。
• 邀請一旦被接受、被撤銷，或滿 7 天，就會從清單上消失。
• 移除一名管理員，或把他改為成員，會撤回他建立、還沒被接受的所有邀請。

從 API 操作

建立邀請是管理員動作，所以需要工作階段權杖。shk_ API 金鑰在每一個管理員端點都會被拒絕，就算建立它的人是管理員也一樣。

curl -X POST "$SUPERHEAT_API/v1/orgs/current/invites" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Org-Id: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"email": "teammate@company.com", "role": "member"}'

{
  "invite": {
    "id": "0f1c9e2a-8a1e-4a1b-9a52-2f3f0b6f6a11",
    "email": "teammate@company.com",
    "role": "member",
    "created_at": "2026-03-04T10:12:00Z",
    "expires_at": "2026-03-11T10:12:00Z"
  },
  "invite_url": "https://console.superheat.cloud/join?token=…"
}

invite_url 是權杖唯一出現的地方。

端點	誰可以呼叫
POST /v1/orgs/current/invites	管理員，僅限工作階段權杖
GET /v1/orgs/current/invites	管理員 — 未接受、未過期的邀請
DELETE /v1/orgs/current/invites/{invite_id}	管理員 — 撤銷
GET /v1/orgs/invites/pending	任何已登入的使用者 — 寄到自己信箱的邀請；手機號碼帳號永遠拿到空清單
POST /v1/orgs/invites/preview	任何已登入的使用者，請求內容為 {"token": "…"} — 回傳 org_id、org_name、role、inviter 與 expires_at，但不會接受邀請
POST /v1/orgs/invites/{invite_id}/accept	被邀請的使用者，接受其中一個
POST /v1/orgs/invites/accept	任何已登入的使用者，主體帶 {"token": "…"}

新成員第一天拿到什麼

他們立刻共用組織的餘額、執行個體、範本、API 金鑰與使用紀錄。他們不會共用你的 SSH 金鑰 — 那些留在每個使用者自己的帳號上。團隊 頁面以電子郵件列出每位成員；沒有電子郵件的手機號碼帳號（例如用手機號碼註冊、自己建立了組織的管理員）會顯示為帶國際區碼的手機號碼，例如 +8613800138000。成員究竟能做什麼，請見角色與權限；哪些東西留在界線的另一邊，請見切換組織。

相關內容

• 角色與權限
• 切換組織
• 組織