邀请 API

通过邮箱邀请用户加入工作空间。邀请包含唯一令牌和过期时间。

TIP

组织级邀请请参见组织邀请 API。推荐使用组织邀请来添加新团队成员 — 它同时授予组织及其工作空间的访问权限。

列出邀请

需要 admin 角色。

GET /api/v1/workspaces/{workspace_id}/invitations
Authorization: Bearer <token>

响应 200 OK

[
  {
    "id": "uuid",
    "workspace_id": "uuid",
    "email": "alice@example.com",
    "role": "developer",
    "status": "pending",
    "inviter_name": "Bob",
    "expires_at": "2026-01-08T00:00:00Z",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

发送邀请

需要 admin 角色。

POST /api/v1/workspaces/{workspace_id}/invitations
Content-Type: application/json

{
  "email": "alice@example.com",
  "role": "developer",
  "message": "欢迎加入团队！"
}

重新发送邀请

重新发送邮件并刷新过期时间。

POST /api/v1/workspaces/{workspace_id}/invitations/{invitation_id}/resend

查询邀请信息（公开接口）

无需认证。用于接受邀请页面显示邀请详情。

GET /api/v1/invitations/info?token=<invitation_token>

接受邀请

POST /api/v1/invitations/accept
Content-Type: application/json

{
  "token": "invitation-token-string"
}

成功后用户自动成为工作空间成员，角色为邀请时指定的角色。

撤销邀请

DELETE /api/v1/workspaces/{workspace_id}/invitations/{invitation_id}