Skip to main content
PATCH
/
v1
/
sessions
/
{session_id}
/
status
Update Session Status
curl --request PATCH \
  --url https://identity.contra.id/v1/sessions/{session_id}/status

​
Request

curl -X PATCH https://identity.contra.id/v1/sessions/$SID/status \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "new_status": "approved",
    "comment":    "Manual review passed · senior compliance",
    "send_email": true,
    "email_address": "user@example.com"
  }'
BodyTypeRequiredDescription
new_statusenumyesapproved · declined · resubmitted · in_review.
commentstringnoFree-text reason (audited).
send_emailbooleannoNotify the user.
email_addressstringconditionalRequired when send_email is true.
nodes_to_resubmitarraynoFor resubmitted → [{ node_type, feature }].

​
Response · 200

Same shape as Get Decision, with status updated and a new entry in the session reviews log.