PUT/v1/cases/{id}/status

Update case status

Transition an investigation unit through the institutional workflow. Every state change requires a rationale note which is cryptographically sealed into the custodial timeline for future auditability.

Authentication ProtocolBearer <API_KEY>

Path Parameters

idintegerRequired

The internal case identifier.

statusstringRequired

open, investigating, pending_review, escalated, resolved, or closed.

notesstringRequired

Investigative rationale for the workflow transition.

Transmission Examples

curl
curl -X PUT https://api.topsafe.ai/api/v1/cases/29/status \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "X-API-Key: YOUR_INSTITUTION_KEY" \
  -d '{
    "status": "resolved",
    "notes": "Verified source of funds via physical site visit. Activity legitimate."
  }'

Schema Response

json
{
  "success": true,
  "message": "Workflow transition successful",
  "data": {
    "id": 29,
    "status": "resolved",
    "updated_at": "2026-04-21T14:42:00+00:00"
  }
}
Preliminary ResourceAttach evidenceSuccessive Directive Close case