API Reference

Admin

Organization

Projects

Data Retention

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Retrieve project data retention

GET/organization/projects/{project_id}/data_retention

Retrieves project data retention controls.

Path ParametersExpand Collapse

project_id: string

ReturnsExpand Collapse

ProjectDataRetention object { object, type }

Represents a project’s data retention control setting.

object: "project.data_retention"

The object type, which is always project.data_retention.

type: "organization_default" or "none" or "zero_data_retention" or 3 more

The configured project data retention type.

One of the following:

"organization_default"

"none"

"zero_data_retention"

"modified_abuse_monitoring"

"enhanced_zero_data_retention"

"enhanced_modified_abuse_monitoring"

Retrieve project data retention

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

CLI Tool

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

{
    "object": "project.data_retention",
    "type": "organization_default"
}

Returns Examples

{
    "object": "project.data_retention",
    "type": "organization_default"
}