REST API

Full ingest and report API reference.

The Videlic REST API lets you upload sessions and fetch reports programmatically.

Base URL

https://api.videlic.dev/v1

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the dashboard → Settings → API Keys.

Upload a session

POST /sessions

Content-Type: multipart/form-data

file       required   Session log file (.jsonl, .log, .txt)
agent      optional   Agent hint: "claude-code" | "cline" | "cursor"
repo       optional   Repository name for grouping

Response:

{
  "id": "ses_abc123",
  "status": "analyzing",
  "report_url": "https://videlic.dev/s/abc123"
}

Get a report

GET /sessions/:id/report

Returns the full report with trust score, findings, and timeline once analysis is complete.

List sessions

GET /sessions?repo=my-repo&limit=20&page=1

Slack Webhook