GET/organization/projects/{project_id}/data_retention

Retrieve project data retention settings

Retrieves the data retention controls configured for a project. Use this operation to inspect the project's current retention type before changing its settings.

1 parameter
project_idstringrequired
The unique identifier of the project whose data retention controls to retrieve.

4 status codes
200Returns the project's data retention setting, including its configured `type`.
objectstringrequired
The object type, which is always `project.data_retention`.
Allowed:project.data_retention
typestringrequired
The configured project data retention type.
Allowed:organization_defaultnonezero_data_retentionmodified_abuse_monitoringenhanced_zero_data_retentionenhanced_modified_abuse_monitoring
400Returned when the project ID is invalid.
errorobjectrequired
403Returned when the authenticated user does not have permission to retrieve the project's data retention controls.
errorobjectrequired
Details about the permission error.
404Returned when the organization or project is not found.
errorobjectrequired

Error handling

A 400 is returned when the project ID is invalid; a 403 is returned when the authenticated user lacks permission; and a 404 is returned when the organization or project is not found. The project_id path parameter must identify the project whose retention controls you want to retrieve.