Sample - OpenAI API
DELETE/organization/groups/{group_id}

Delete a group

Deletes a group from the organization. Supply group_id to identify the group you want to remove. A successful response confirms the deleted group's identifier and deletion status.

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

1 parameter
group_idstringrequired
The unique identifier of the group to delete.

2 status codes
200Returns a deletion confirmation containing the `group.deleted` object type, the deleted group's identifier, and a boolean indicating whether deletion occurred.
objectstringrequired
Always `group.deleted`.
Allowed:group.deleted
idstringrequired
Identifier of the deleted group.
deletedbooleanrequired
Whether the group was deleted.
429Returned when the request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

group_id must identify the group you want to delete. A 429 is returned when the request exceeds the applicable rate limit.