Key Endpoints

Sanitization API

Endpoint: POST /sanitize

Purpose: Redacts sensitive information based on context and domain.

Request Parameters:

• text (required): The raw text to sanitize.
• domain (optional): Context-specific domain (e.g., Health or Finance).
• conversation_id (optional): Reuse obfuscation maps for ongoing conversations.
• encryption_key (optional): Adds encryption for obfuscation maps.

Response Parameters:

• is_sensitive: Indicates if sensitive data was detected.
• sanitized_text: Text with sensitive details contextually redacted.
• sanitization_result: Includes status (Success or Fail) and a reason for any failure.

De-sanitization API

Endpoint: POST /desanitize

Purpose: Reconstructs original text from sanitized input using obfuscation maps.

Request Parameters:

• redacted_text (required): The sanitized text.
• conversation_id (optional): Tracks and reuses obfuscation maps.
• decryption_key (optional): Unlocks secure obfuscation maps.

Response Parameters:

• original_text: Reconstructed original text.

Sample API Call: Sanitization

curl -X POST "https://wald-ai-endpoint.com/sanitize" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer WALD_API_KEY" \
  -d '{
    "text": "The patient John Doe, 65, was diagnosed with hypertension.",
    "domain": "Health",
    "conversation_id": "conversation_123",
    "encryption_key": "encryption_key_123"
  }'

Response:

{
  "is_sensitive": true,
  "conversation_id": "conversation_123",
  "sanitization_result": {
    "status": "Success",
    "reason": ""
  },
  "sanitized_text": "The patient [REDACTED PATIENT], [REDACTED AGE], was diagnosed with hypertension."
}