Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Get project safety alert

safety.alerts.retrieve(id) -> SafetyAlert { id, created_at, error_type, 7 more }
GET
/safety/alerts/{id}

Get a safety alert belonging to the authenticated API project.

Parameters
id: String

Project safety alert ID

maxLength38
Returns
class SafetyAlert { id, created_at, error_type, 7 more }
id: String
created_at: Integer
formatunixtime
error_type: :potentially_unintended_data_transfer | :potentially_unintended_data_access | :potentially_unintended_destructive_activity | :other
model: String
object: :"safety.alert"
reason: String

A customer-safe description derived from error_type, or null for zero data retention requests.

request_id: String
request_paused: bool

Whether block registration succeeded for this request. This does not confirm that response execution stopped.

response_id: String
detailed_explanation: String

A generated explanation, temporarily available for eligible zero data retention alerts. Omitted when unavailable.

Get project safety alert

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

safety_alert = openai.safety.alerts.retrieve("id")

puts(safety_alert)
Response example
{
  "id": "alert_0123456789abcdef0123456789abcdef",
  "object": "safety.alert",
  "created_at": 1787659200,
  "request_id": "req_123",
  "response_id": "resp_123",
  "model": "gpt-6-astra",
  "request_paused": true,
  "error_type": "potentially_unintended_data_access",
  "reason": "Potentially unintended data access."
}
Returns Examples
Response example
{
  "id": "alert_0123456789abcdef0123456789abcdef",
  "object": "safety.alert",
  "created_at": 1787659200,
  "request_id": "req_123",
  "response_id": "resp_123",
  "model": "gpt-6-astra",
  "request_paused": true,
  "error_type": "potentially_unintended_data_access",
  "reason": "Potentially unintended data access."
}