API Reference

Admin

Organization

Projects

Groups

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Retrieve project group

GET/organization/projects/{project_id}/groups/{group_id}

Retrieves a project’s group.

Path ParametersExpand Collapse

project_id: string

group_id: string

Query ParametersExpand Collapse

group_type: optional "group" or "tenant_group"

The type of group to retrieve.

One of the following:

"group"

"tenant_group"

ReturnsExpand Collapse

ProjectGroup object { created_at, group_id, group_name, 3 more }

Details about a group’s membership in a project.

created_at: number

Unix timestamp (in seconds) when the group was granted project access.

formatunixtime

group_id: string

Identifier of the group that has access to the project.

group_name: string

Display name of the group.

group_type: "group" or "tenant_group"

The type of the group.

One of the following:

"group"

"tenant_group"

object: "project.group"

Always project.group.

project_id: string

Identifier of the project.

Retrieve project group

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

CLI Tool

curl https://api.openai.com/v1/organization/projects/proj_abc123/groups/group_01J1F8ABCDXYZ \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
    "object": "project.group",
    "project_id": "proj_abc123",
    "group_id": "group_01J1F8ABCDXYZ",
    "group_name": "Support Team",
    "group_type": "group",
    "created_at": 1711471533
}

Returns Examples

{
    "object": "project.group",
    "project_id": "proj_abc123",
    "group_id": "group_01J1F8ABCDXYZ",
    "group_name": "Support Team",
    "group_type": "group",
    "created_at": 1711471533
}