> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontra.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Session Status

> Override a session's status — approve, decline, or request resubmission.

## Request

```bash theme={null}
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"
  }'
```

| Body                | Type    | Required    | Description                                            |
| ------------------- | ------- | ----------- | ------------------------------------------------------ |
| `new_status`        | enum    | **yes**     | `approved` · `declined` · `resubmitted` · `in_review`. |
| `comment`           | string  | no          | Free-text reason (audited).                            |
| `send_email`        | boolean | no          | Notify the user.                                       |
| `email_address`     | string  | conditional | Required when `send_email` is `true`.                  |
| `nodes_to_resubmit` | array   | no          | For `resubmitted` → `[{ node_type, feature }]`.        |

## Response · 200

Same shape as [Get Decision](/api-reference/sessions/get-decision), with `status` updated and a new entry in the session reviews log.