API

Analyze documents programmatically

One endpoint, an API key, multipart upload. Create a key in your dashboard and start scanning from your own pipeline.

Authentication

Every request must include your API key in the x-api-key header. Create and revoke keys under Dashboard → API keys.

POST /api/v1/analyze

Send one file as multipart form-data in the field arq. Accepted: PDF, .docx, .xlsx (≤ 50 MB).

curl -X POST https://api.promptrisk.ai/promptrisk/api/v1/analyze \ -H "x-api-key: pr_live_your_key_here" \ -F "arq=@/path/to/document.pdf"

Response

{ "file": "document.pdf", "success": true, "format": "pdf", "score": 66, "classification": "HIGH", "recommendation": "High risk. Reject or require author review ...", "detections": [ { "patternId": 3, "category": "Explicit instruction override", "severity": "HIGH", "confidence": "high", "origin": "hybrid", "evidence": "IGNORE ALL PREVIOUS INSTRUCTIONS ..." } ], "error": null }

Classification bands

0–20SAFE
21–40LOW
41–60MODERATE
61–80HIGH
81–100CRITICAL

Create an account