Protect API

Analyze content and optionally redact sensitive information in a single call.

Endpoint

POST /v1/protect

Request Body

Parameter	Type	Required	Description
content	string	Yes	The content to protect
redact	boolean	No	Whether to redact PII (default: true)
redactTypes	string[]	No	Specific PII types to redact
replacement	string	No	Replacement text (default: "[REDACTED]")

Example Request

curl https://api.talonai.io/v1/protect \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "My email is john@example.com and SSN is 123-45-6789",
    "redact": true,
    "redactTypes": ["email", "ssn"]
  }'

Response

{
  "id": "protect_xyz789",
  "original": "My email is john@example.com and SSN is 123-45-6789",
  "protected": "My email is [EMAIL] and SSN is [SSN]",
  "analysis": {
    "riskScore": 45,
    "riskLevel": "medium",
    "isSafe": true
  },
  "redactions": [
    {
      "type": "email",
      "original": "john@example.com",
      "replacement": "[EMAIL]",
      "start": 12,
      "end": 28
    },
    {
      "type": "ssn",
      "original": "123-45-6789",
      "replacement": "[SSN]",
      "start": 41,
      "end": 52
    }
  ],
  "piiTypes": ["email", "ssn"]
}

Supported PII Types

ssn

credit_card

phone

address

ip_address

passport

driver_license

bank_account

api_key