OpenAI 创建群组

创建群组

post /organization/groups

在组织中创建一个新群组。

请求体参数

内容类型：application/json

• name: string

便于阅读的群组名称。

minLength: 1, maxLength: 255

返回值

• Group object { id, created_at, group_type, 2 more }

组织群组的详细信息。

• id: string

群组标识符。

• created_at: integer

群组创建时的 Unix 时间戳，单位为秒。

format: unixtime

• group_type: "group" or "tenant_group"

群组类型。

• "group"

• "tenant_group"

• is_scim_managed: boolean

群组是否通过 SCIM 管理并由你的身份提供商控制。

• name: string

群组显示名称。

示例

## 从环境变量读取管理员密钥；群组、角色和用户ID应替换为实际值
curl https://api.openai.com/v1/organization/groups \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "name": "x"
        }'

200 — 示例

以下 JSON 展示返回字段；字段名、对象类型、权限字符串和标识符按原文保留。

{
  "id": "id",
  "created_at": 0,
  "group_type": "group",
  "is_scim_managed": true,
  "name": "示例名称"
}

示例

## 从环境变量读取管理员密钥；群组、角色和用户ID应替换为实际值
curl -X POST https://api.openai.com/v1/organization/groups \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "支持团队"
  }'

响应示例

以下为对应请求的响应示例，名称和描述已中文化。

{
    "object": "group",
    "id": "group_01J1F8ABCDXYZ",
    "name": "支持团队",
    "created_at": 1711471533,
    "group_type": "group",
    "is_scim_managed": false
}