codecamp

OpenAI 列出群组

列出群组

get /organization/groups

列出组织中的所有群组。

查询参数

  • after: optional string

分页游标。after 是标记列表位置的群组 ID。例如,列表请求返回100个对象,最后一个为 group_abc;后续调用可传入 after=group_abc,以获取下一页。

  • limit: optional integer (default: 100)

返回的群组数量上限。取值范围为0至1000,默认值为100。

minimum: 0, maximum: 1000

  • order: optional "asc" or "desc" (default: "asc")

指定返回群组的排序方式。

  • "asc"

  • "desc"

返回值

  • data: array of Group

当前页返回的群组。

  • id: string

群组标识符。

  • created_at: integer

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

format: unixtime

  • group_type: "group" or "tenant_group"

群组类型。

  • "group"

  • "tenant_group"

  • is_scim_managed: boolean

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

  • name: string

群组显示名称。

  • has_more: boolean

分页时是否还有其他群组可获取。

  • next: string or null

获取下一页结果的游标;没有更多结果时为 null。

  • object: "list"

固定为 list。

  • "list"

示例

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

200 — 示例

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

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "group_type": "group",
      "is_scim_managed": true,
      "name": "示例名称"
    }
  ],
  "has_more": true,
  "next": "next",
  "object": "list"
}

示例

## 从环境变量读取管理员密钥;群组、角色和用户ID应替换为实际值
curl https://api.openai.com/v1/organization/groups?limit=20&order=asc \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

响应示例

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

{
    "object": "list",
    "data": [
        {
            "object": "group",
            "id": "group_01J1F8ABCDXYZ",
            "name": "支持团队",
            "created_at": 1711471533,
            "group_type": "group",
            "is_scim_managed": false
        }
    ],
    "has_more": false,
    "next": null
}
OpenAI 删除群组
OpenAI 为群组分配组织角色
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

其他能力与进阶指南

Embeddings 接口参考

审计日志接口参考

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }