API Reference

Projects

Roles

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete project role

DELETE/projects/{project_id}/roles/{role_id}

Deletes a custom role from a project.

Path ParametersExpand Collapse

project_id: string

role_id: string

ReturnsExpand Collapse

id: string

Identifier of the deleted role.

deleted: boolean

Whether the role was deleted.

object: "role.deleted"

Always role.deleted.

Delete project role

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

curl -X DELETE https://api.openai.com/v1/projects/proj_abc123/roles/role_01J1F8PROJ \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
    "object": "role.deleted",
    "id": "role_01J1F8PROJ",
    "deleted": true
}

Returns Examples

{
    "object": "role.deleted",
    "id": "role_01J1F8PROJ",
    "deleted": true
}