---
title: "Reapply for email onboarding review"
method: POST
path: "/v1/email/onboarding-review/reapply"
tags: ["Email"]
---

# Reapply for email onboarding review

`POST /v1/email/onboarding-review/reapply`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/email/onboarding-review/reapply`
- Auth: API key in header `x-api-key`

Allows an organization owner or admin to submit a rejected organization for review again. The expected generation prevents acting on stale status.

## Request body

- ReapplyOnboardingReviewInput
  - `expectedGeneration` integer, required

## Response `200`

OnboardingReviewStatus

- OnboardingReviewStatus
  - `decision` 'undecided' | 'approved' | 'rejected', required
  - `trustTier` 'screened' | 'probation' | 'established', required
  - `stage` 'collecting' | 'automated_review' | 'manual_review' | 'information_requested' | 'complete', required
  - `generation` integer, required
  - `canSend` boolean, required
  - `code` 'review_required' | 'review_in_progress' | 'information_required' | 'review_rejected' | 'identity_review_required' | 'identity_review_rejected' | 'identity_changed', nullable, required
  - `nextAction` 'wait_for_review' | 'provide_information' | 'verify_sending_identity' | 'reapply' | 'contact_support', nullable, required
  - `canReapply` boolean, required
  - `informationRequest` object, nullable, required
    - `id` string, required
    - `requestedFields` string[], required
    - `requestedAt` string, required
    - `canRespond` boolean, required
  - `identities` IdentityClearanceStatus[], required
    - `identityId` string, required
    - `decision` 'undecided' | 'approved' | 'rejected', required
    - `generation` integer, required
    - `canSend` boolean, required
    - `code` 'review_required' | 'review_in_progress' | 'information_required' | 'review_rejected' | 'identity_review_required' | 'identity_review_rejected' | 'identity_changed', nullable, required
    - `nextAction` 'wait_for_review' | 'provide_information' | 'verify_sending_identity' | 'reapply' | 'contact_support', nullable, required
    - `updatedAt` string, required
  - `updatedAt` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `409`: ConflictError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)