Submit a scan

Upload media or pass a URL. Get a fused verdict and per-dimension evidence.

POST/api/v1/scans/upload-intents

curl -X POST https://api.plurall.tech/api/v1/scans/upload-intents \
  -H "Authorization: Bearer $PLURALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName":"clip.mp4","contentType":"video/mp4","mediaType":"video","byteSize":1048576}'
Operation
Create a scan upload intent
Scopes
scans:write
Request
ScanUploadIntentRequest
Response
201 ScanUploadIntentResponse

POST /api/v1/scans/upload-intents creates a private upload intent. POST /api/v1/scans/url-intents creates a reference-only HTTPS URL scan boundary. After direct upload, POST /api/v1/scans/{id}/upload-complete produces the persisted result. The fused verdict, per-dimension evidence, and pipeline trace are populated as the scan moves through the pipeline.

Request

Pass either file (multipart) or url in the body. Optional metadata is echoed back so you can reconcile the scan with your own ids.

Response

Plurall AI returns a JSON envelope: { id, status, verdict, confidence, fusion, evidence[], pipeline[], audit[] }. The evidence array contains one entry per forensic dimension with a 0..1 score, a label, and a short narrative.

Polling

If you can't subscribe to webhooks, poll GET /api/v1/scans/{id}/job or GET /api/v1/scans/{id}. Use response metadata and the job status to avoid unnecessary polling under load.