邀请成员

POST/v2/orgs/{org_id}/invitations

按邮箱批量邀请成员加入组织，可预设角色与过期时间。

同一邮箱在 24 小时内重复邀请不会重复发送邮件，仅刷新过期时间。邀请链接携带一次性令牌，接受后自动加入组织。

Bearer Token orgs:write api.demo.acme-cloud.dev

请求参数

共 1 项

org_id 必填路径

string

组织 ID

请求体

application/json

emails 必填

array<string>

被邀请邮箱列表，单次最多 50 个

role 必填

string · 默认 member

预置角色

可选值adminmemberviewer

expires_in_days 可选

integer · 默认 7

邀请有效期（天）

message 可选

string

随邀请邮件附带的留言，最多 200 字

响应

4 种状态

201 Created

响应示例

{
  "invitations": [
    {
      "email": "newbie@acme.com",
      "invitation_id": "inv_6e2b9d",
      "role": "member",
      "status": "sent",
      "expires_at": "2026-10-23T07:30:00Z"
    }
  ]
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/orgs/org_2c91/invitations' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "emails": [
    "newbie@acme.com"
  ],
  "role": "member",
  "expires_in_days": 7,
  "message": "欢迎加入 Acme 平台组！"
}'