Safety

Analyze a PDF or image for safety and compliance concerns

Upload a PDF (max 50MB, max 100 pages) or a single image (png, jpeg, webp) for multi-endpoint safety analysis. PDFs are read from the text layer per page; images are read by OCR and analysed as a one-page document. Choose which detectors run with the endpoints field. For a messaging screenshot, set split_by_sender=true to have the conversation split into messages with a side attributed to each, so the detector judges the last received message with the rest as history; this costs one additional vision call. Returns per-page results with an overall risk assessment, plus a SHA-256 hash of the uploaded file for chain-of-custody verification. Zero-retention: no document or image data is stored after processing.

post/api/v1/safety/document

Request

  • Base URL: https://api.tuteliq.ai
  • URL: https://api.tuteliq.ai/api/v1/safety/document
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Response

Default Response

file_idstring

Client-provided file identifier (echoed back)

document_hashstring

SHA-256 hash of the uploaded PDF for chain-of-custody verification

total_pagesnumber

Total pages in the document

pages_analyzednumber

Pages with extractable text that were analyzed

overall_risk_scorenumber

Highest risk score across all pages

overall_severity'none' | 'low' | 'medium' | 'high' | 'critical'
detected_endpointsstring[]

Endpoints that detected threats

credits_usednumber
processing_time_msnumber
languagestring
language_statusstring
supportobject
external_idstring
incident_moderation_enabledstring

Per-call override of account incident logging: "true" forces persistence, "false" suppresses it. Omit for account default.

customer_idstring
metadataobject

Changes

No recorded changes to this operation across all 1 revision of this API.