Sample - OpenAI API
POST/organization/projects/{project_id}/groups

Add a group to a project

Grants a group access to a project. Supply the group identifier in group_id and the project role to grant in role. The response contains the resulting project group membership.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields
project_idstringrequired
The ID of the project to grant access to.

The group access assignment containing the group and project role.

group_idstringrequired
Identifier of the group to add to the project.
rolestringrequired
Identifier of the project role to grant to the group.

2 status codes
200Returns the project group membership with the project, group, group type, display name, and creation timestamp.
objectstringrequired
Always `project.group`.
Allowed:project.group
project_idstringrequired
Identifier of the project.
group_idstringrequired
Identifier of the group that has access to the project.
group_namestringrequired
Display name of the group.
group_typestringrequired
The type of the group.
Allowed:grouptenant_group
created_atintegerrequired
Unix timestamp (in seconds) when the group was granted project access.
429Returned when the request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. group_id and role are required and must identify the group and project role to assign. project_id must identify the project receiving the group access.