メインコンテンツへスキップ
POST
curl

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

ヘッダー

Content-Type
string

JSONボディを送信する場合はapplication/jsonに設定します。

例:

"application/json"

パスパラメータ

session_id
string<uuid>
必須

ユーザー認証 (KYC) セッションのUUIDです。APIキーと同じアプリケーションに属している必要があります。別のアプリケーションのUUID、削除済みのセッション、法人確認 (KYB) セッションのIDはいずれも404を返します。

例:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

ボディ

application/json
new_status
enum<string> | null

エントリーに記録する任意のステータスラベルです。セッションのステータス値であればどれでも受け付けますが、大文字と小文字は区別されます("approved"は400で拒否されます)。ここでステータスを記録しても、セッションの実際のステータスは変更されません。変更するにはupdate-statusエンドポイントを使用してください。

利用可能なオプション:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
例:

"In Review"

comment
string | null

任意の自由記述のメモです(文字数制限は適用されません)。入力内容はそのまま保存されます。このエンドポイントでは@emailのメンションは処理されません。

例:

"Flagging for manual document re-check."

レスポンス

セッションの監査証跡に記録されたエントリ。セッション自体は変更されません。statusは以前の値のままで、Webhookは送信されません。新しいエントリはGET …/reviews/の先頭にも表示されます(actor_display: "Unknown"付き)。

user
string

エントリー作成者の表示名です。このエンドポイントは操作者を記録しないため、このエンドポイントで作成されたエントリーでは常に"Unknown"となります。

例:

"Unknown"

new_status
enum<string> | null

エントリに記録されたステータスラベル。送信されなかった場合はnullです。セッションの実際のステータスには影響しません。

利用可能なオプション:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
例:

"In Review"

comment
string | null

エントリーに記録されたメモ。送信されなかった場合はnullです。

例:

"Flagging for manual document re-check."

created_at
string<date-time>

エントリーが書き込まれた日時(ISO 8601、UTC)。

例:

"2026-06-12T00:18:44.466537Z"

最終更新日 2026年11月1日