Proceedings

A proceeding is one session on the record: the witness, the schedule and everything captured during it.

List and read

GET/proceedingsfilter with case_id and status
GET/proceedings/{id}
curl
curl "https://aisicario.me/api/public/v1/proceedings?case_id=c1f2…" \
  -H "Authorization: Bearer $AISICARIO_API_KEY"

Schedule one

POST/proceedingswrite scope
curl
curl https://aisicario.me/api/public/v1/proceedings \
  -H "Authorization: Bearer $AISICARIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "case_id": "c1f2…",
    "title": "Deposition of J. Doe",
    "witness_name": "J. Doe",
    "witness_title": "Operations manager",
    "scheduled_at": "2026-04-02T15:00:00Z",
    "duration_minutes": 240,
    "location": "Remote"
  }'

Move it along

PATCH/proceedings/{id}status: scheduled, in_progress, completed, cancelled, paused
curl
curl -X PATCH https://aisicario.me/api/public/v1/proceedings/p9a1… \
  -H "Authorization: Bearer $AISICARIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

Marking a proceeding completed sends the proceeding.ended notification to your registered addresses.

Insights

GET/proceedings/{id}/insightsread scope
POST/proceedings/{id}/insightsanalyze scope, billed by the minute

Requesting analysis is charged at the published rate. When it finishes we send analysis.finished.