POST/api/v1/orgs/invitations/:token/accept接受组织邀请

Try it 面板需要启用 JavaScript。

凭邀请令牌（邀请消息中携带）加入组织并自动获得指定角色；令牌一次性。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name	Data Type	Description
token	string	邀请令牌（一次性）

Response

Body

OrgDTO

Name	Data Type	Required	Description
orgId	string	Yes	组织 ID
name	string	Yes	组织名称
description	string	No	组织描述
ownerId	string	Yes	所有者用户 ID
memberCount	number	Yes	成员数
createdAt	string	Yes	创建时间（ISO 8601 UTC）

type OrgDTO = {
  /** 组织 ID */
  orgId: string
  /** 组织名称 */
  name: string
  /** 组织描述 */
  description?: string
  /** 所有者用户 ID */
  ownerId: string
  /** 成员数 */
  memberCount: number
  /** 创建时间（ISO 8601 UTC） */
  createdAt: string
}

{
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
  "name": "Xeegam 上海",
  "description": "Xeegam 上海研发团队",
  "ownerId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "memberCount": 12,
  "createdAt": "2026-09-01T02:00:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	已加入组织
400	令牌无效	邀请不存在或已过期
409	已是成员	当前用户已在该组织中

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	已加入组织
2502	邀请令牌无效	不存在或已过期
2503	邀请已被使用	令牌一次性，已被消费
2504	用户已是成员	当前用户已在该组织中

Examples

POST /api/v1/orgs/invitations/inv_8a3d92f1c07b6e54/accept
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SS3JW8H2J0LE",
  "code": 0,
  "messages": [],
  "result": {
    "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
    "name": "Xeegam 上海",
    "description": "Xeegam 上海研发团队",
    "ownerId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
    "memberCount": 13,
    "createdAt": "2026-09-01T02:00:00Z"
  }
}

Remarks

令牌不绑定被邀用户——收到邀请的任何人凭令牌均可加入；接受即消费。