セッションを再処理する

POST

/v1/verification-sessions/{id}/reprocess

curl --request POST \
  --url https://api.trust.supa-stg.ai/v1/verification-sessions/example/reprocess \
  --header 'Authorization: Bearer <token>'

• staging

Completed / failed / reviewing のセッションを collecting に戻し、期限(expiresAt)を設定し直す。確認はすぐには走らず、利用者の再提出を待つ。新しい判定が確定すると webhook がもう 1 回届く(別のイベント ID)。応答に検証 URL は含まれない。利用者が再提出するには、管理画面で検証 URL を再発行して渡す。expired のセッションは再処理できないので新しく作る

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

Responses

200

再処理を受け付けたセッション。status は collecting に戻る

Media typeapplication/json

object

id

required

セッション ID(vs_ + 32 桁の 16 進)

/^vs_[0-9a-f]{32}$/

status

required

セッションの進み具合。created = 作成済み(利用者が未着手)/ collecting = 利用者が提出中 / deciding = 判定中 / reviewing = 手動レビュー待ち / completed = 判定が確定 / expired = 利用者が終えないまま期限切れ / failed = 回復できないエラーで終了。承認か否認かは status ではなく outcome.verdict で見る

string

Allowed values: created collecting deciding reviewing completed expired failed

plan

required

このセッションで行う確認の手順(作成時のテナント設定で決まる)

object

steps

required

Array<string>

Allowed values: document selfie

expiresAt

required

セッションの期限。created / collecting のままこの時刻を過ぎると expired になる

string

createdAt

required

作成日時

string

metadata

required

Any of:

object

自社側の相関用に渡す任意の JSON オブジェクト(自社のユーザー ID など)。JSON にして 8192 バイトまで。webhook にもそのまま載るので個人情報を入れない

object

null

null

Example

{
  "id": "vs_00000000000000000000000000000001",
  "status": "created",
  "plan": {
    "steps": [
      "document"
    ]
  },
  "expiresAt": "2026-08-02T12:34:56.000Z",
  "createdAt": "2026-08-02T12:34:56.000Z",
  "metadata": {
    "userId": "user_0001"
  }
}

401

API キーが無い・正しくない・失効している(理由は区別しない)。Authorization: Bearer <API キー> を確かめる

Media typeapplication/json

object

_tag

required

string

Allowed values: Unauthorized

message

required

string

Example

{
  "_tag": "Unauthorized"
}

403

テナントの IP 許可リストに無いアドレスからの呼び出し。API キーは有効。許可リストの設定を確かめる

Media typeapplication/json

object

_tag

required

string

Allowed values: IpNotAllowed

message

required

string

Example

{
  "_tag": "IpNotAllowed"
}

404

セッションが無い。他テナントのセッション・形式が正しくない ID も同じく 404(個人情報を消去済みのセッションは 404 にならない)

Media typeapplication/json

object

_tag

required

string

Allowed values: SessionNotFound

id

required

string

Example

{
  "_tag": "SessionNotFound"
}

409

今の状態では再処理できない(status が completed / failed / reviewing 以外・個人情報を消去済み・同時の操作と衝突)。GET で status を確かめる。expired は再処理できないので新しいセッションを作る

Media typeapplication/json

object

_tag

required

string

Allowed values: ReprocessNotAllowed

id

required

string

Example

{
  "_tag": "ReprocessNotAllowed"
}