API Reference

Safety

Alerts

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get project safety alert

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

GET/safety/alerts/{id}

Get a safety alert belonging to the authenticated API project.

ParametersExpand Collapse

id: String

Project safety alert ID

maxLength38

ReturnsExpand Collapse

class SafetyAlert { id, created_at, error_type, 6 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

Get project safety alert

Ruby

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

require "openai"

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

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

puts(safety_alert)

{
  "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

{
  "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."
}